如何在WinSW XML配置文件中使用环境变量？

我已在Windows Nano Server中配置了SGW_HOME环境变量，尝试在WinSW XML配置文件中使用该变量，配置内容如下：

<service>
  <!-- ID of the service. It should be unique across the Windows system-->
  <id>SGWJavaService</id>
  <name>SGWJavaService</name>
  <description>SGW Java service</description>
  <env name="SGW_HOME" value="%SGW_HOME%"/>
  <!-- Path to the executable, which should be started -->
  <!-- CAUTION: Don't put arguments here. Use <arguments> instead. -->
  <executable>java</executable>
  <arguments>-jar %SGW_HOME%\lib\mgmt-node-1.0.0.jar</arguments>
</service>

通过以下命令创建服务：

WinSW-x64.exe install sgw.xml

但服务启动失败，执行sc query命令结果如下：

C:\program-files>sc query SGWJavaService

SERVICE_NAME: SGWJavaService
        TYPE               : 10  WIN32_OWN_PROCESS
        STATE              : 1  STOPPED
        WIN32_EXIT_CODE    : 1067  (0x42b)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0

请问该如何在XML配置文件中正确使用环境变量？

解决方案 #

1. 移除冗余的<env>节点 #

你已经在系统中配置了SGW_HOME环境变量，无需在WinSW的XML配置里重复定义——重复定义会导致变量解析异常，甚至覆盖系统中已有的值，直接删除<env name="SGW_HOME" value="%SGW_HOME%"/>这一行即可。

2. 确保环境变量的作用域正确 #

Windows服务默认以系统账户运行，只能读取系统级环境变量：

• 若SGW_HOME是用户级变量：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，将SGW_HOME移到「系统变量」区域，设置完成后重启系统（或重新安装服务）让变量生效。
• 必须使用用户级变量的话：打开服务管理器，找到SGWJavaService，右键→「属性」→「登录」，选择配置了SGW_HOME的用户账户，输入密码后应用，再尝试启动服务。

3. 添加日志配置排查问题 #

在XML中添加日志配置，能查看服务启动时的具体错误信息（比如路径解析失败、Java命令执行异常等），方便定位问题：

<service>
  <id>SGWJavaService</id>
  <name>SGWJavaService</name>
  <description>SGW Java service</description>
  <executable>java</executable>
  <arguments>-jar %SGW_HOME%\lib\mgmt-node-1.0.0.jar</arguments>
  <!-- 日志配置 -->
  <logpath>C:\program-files\sgw-service-logs</logpath>
  <logmode>roll</logmode>
</service>

4. 重新安装服务 #

修改配置后，先卸载旧服务再重新安装，确保配置生效：

WinSW-x64.exe uninstall sgw.xml
WinSW-x64.exe install sgw.xml

5. 测试绝对路径（可选） #

如果不确定环境变量是否生效，可以先把jar路径写成绝对路径测试服务能否启动，排除其他问题后再换回环境变量：

<arguments>-jar C:\your\actual\path\lib\mgmt-node-1.0.0.jar</arguments>

内容的提问来源于stack exchange，提问作者Ganesh Shinde