WinSW服务安装：解决“无法定位XML文件”错误-java教程-PHP中文网

WinSW服务安装：解决“无法定位XML文件”错误

花韻仙語

发布： 2025-09-30 12:28:49

原创

973人浏览过

WinSW服务安装：解决“无法定位XML文件”错误

在使用WinSW将Java应用部署为Windows服务时，用户常遇到System.IO.FileNotFoundException错误，提示无法定位Winsw.[xml|yml]文件。此问题核心在于WinSW的配置机制：它要求其可执行文件（如WinSW.exe）与对应的服务配置文件（如WinSW.xml）具有相同的基本名称，并置于同一目录下。若要部署多个服务，每个服务需独立拥有一个以服务名命名的WinSW可执行文件和配套配置文件。

WinSW简介与常见问题

winsw（windows service wrapper）是一个开源工具，旨在帮助用户将任何可执行文件（如jar文件、批处理脚本等）包装成windows服务运行。它通过一个xml或yaml配置文件来定义服务的行为、启动命令、日志设置等。

然而，在初次使用WinSW安装服务时，许多用户会遇到一个常见的错误：

> Winsw.exe install myapp.xml
2022-11-15 12:24:46,791 FATAL - Unhandled exception
System.IO.FileNotFoundException: Unable to locate Winsw.[xml|yml] file within executable directory
   at WinSW.Program.LoadConfigAndInitLoggers(Boolean inConsoleMode)
   at WinSW.Program.Run(String[] argsArray, IServiceConfig config)
   at WinSW.Program.Main(String[] args)

登录后复制

这个错误表明WinSW无法找到其预期的配置文件，即使在安装命令中明确指定了myapp.xml。问题的根源在于WinSW的特定配置查找逻辑。

错误原因分析

WinSW的设计哲学是，每个服务实例都由一对文件定义：一个WinSW可执行文件和一个同名的配置文件。当您运行Winsw.exe install命令时，WinSW并不会尝试解析您提供的myapp.xml作为要加载的配置路径。相反，它会默认在自身所在的目录下查找一个与自身文件名相同的XML或YAML文件。

例如，如果您的可执行文件是WinSW.exe，它会尝试查找WinSW.xml或WinSW.yml。如果您将其命名为myapp.xml，即使在同一目录下，WinSW也无法找到它，从而抛出FileNotFoundException。

解决方案

解决此问题的核心在于遵循WinSW的命名约定：WinSW可执行文件和其对应的配置文件必须具有相同的基本名称，并位于同一目录下。

重命名配置文件： 将您的XML配置文件重命名，使其与WinSW的可执行文件同名。
- 如果您的WinSW可执行文件是 WinSW.exe，那么配置文件应命名为 WinSW.xml。
- 如果您的WinSW可执行文件是 MyService.exe，那么配置文件应命名为 MyService.xml。
放置在同一目录： 确保重命名后的配置文件与WinSW可执行文件位于同一个目录下。

示例：

假设您有一个名为 my-application.jar 的Java应用，并希望将其作为服务运行。

下载WinSW： 从WinSW的GitHub发布页面下载最新的 WinSW.exe 文件。
创建服务目录： 创建一个专门的目录来存放您的服务文件，例如 C:\Services\MyApplicationService。

法语写作助手
法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

31

查看详情
放置文件： 将 my-application.jar 和下载的 WinSW.exe 放入此目录。

创建配置文件： 创建一个XML配置文件，例如 service-config.xml，内容如下：

<service>
  <id>MyApplicationService</id>
  <name>My Application Service</name>
  <description>This is my sample Java application service.</description>
  <executable>java</executable>
  <arguments>-Xmx512m -jar "my-application.jar"</arguments>
  <logpath>%BASE%\logs</logpath>
  <log mode="roll-by-size">
    <sizeThreshold>10240</sizeThreshold>
    <keepFiles>8</keepFiles>
  </log>
  <onfailure action="restart" delay="60 sec"/>
</service>

登录后复制

重命名WinSW可执行文件和配置文件：
- 将 WinSW.exe 重命名为 MyApplicationService.exe。
- 将 service-config.xml 重命名为 MyApplicationService.xml。
现在，您的 C:\Services\MyApplicationService 目录结构应如下：
```
C:\Services\MyApplicationService\
├── my-application.jar
├── MyApplicationService.exe
└── MyApplicationService.xml
```
登录后复制
安装服务： 打开管理员权限的命令提示符或PowerShell，导航到服务目录，然后执行安装命令：
```
cd C:\Services\MyApplicationService
MyApplicationService.exe install
```
登录后复制
此时，服务将成功安装。