本文详解 WinSW 在 Windows Nano Server 上使用环境变量（如 %SGW_HOME%）的正确方式，涵盖 声明、路径展开时机、 中变量解析限制及替代方案，并提供可立即验证的配置示例与排错要点。

本文详解 winsw 在 windows nano server 上使用环境变量（如 `%sgw_home%`）的正确方式，涵盖 `` 声明、路径展开时机、`` 中变量解析限制及替代方案，并提供可立即验证的配置示例与排错要点。

WinSW 默认不会在 或 标签中自动展开 Windows 批处理风格的环境变量语法（如 %SGW_HOME%）。这是导致服务启动失败（错误代码 1067：进程意外终止）的根本原因——Java 启动命令被字面量解析为 -jar %SGW_HOME%\lib\mgmt-node-1.0.0.jar，而系统无法识别该路径。

✅ 正确做法是：仅在 标签中声明环境变量供子进程继承；所有需变量展开的路径必须通过 或 的间接方式传递，且推荐使用 + 相对路径组合，或改用 传入变量值本身。

✅ 推荐配置方案（可靠、跨平台兼容）

<service>
  <id>SGWJavaService</id>
  <name>SGWJavaService</name>
  <description>SGW Java service</description>

  <!-- ✅ 正确：通过 <env> 将 SGW_HOME 透传给 Java 进程 -->
  <env name="SGW_HOME" value="%SGW_HOME%"/>

  <!-- ✅ 关键：设置工作目录为 SGW_HOME，使后续相对路径生效 -->
  <workingdirectory>%SGW_HOME%</workingdirectory>

  <!-- ✅ 可靠：使用相对路径，避免变量解析失败 -->
  <executable>java</executable>
  <arguments>-jar lib\mgmt-node-1.0.0.jar</arguments>

  <!-- 可选：指定 JVM 参数或日志路径（同样支持 %VAR% 展开） -->
  <logpath>%SGW_HOME%\logs</logpath>
  <logmode>rotate</logmode>
</service>

? 原理说明：WinSW 仅在 、、 等少数标签中支持 %VAR% 语法的启动前展开；而 中的 %SGW_HOME% 完全不解析，会原样传给 Java，导致 FileNotFoundException。

⚠️ 注意事项与排错要点

• Nano Server 兼容性：确保 SGW_HOME 已在系统级环境变量中设置（而非仅当前用户或 CMD 会话），因服务以 LocalSystem 或指定账户运行，不继承交互式会话变量。
• 路径分隔符：Windows 使用反斜杠 \，但 WinSW 内部统一处理为正斜杠 / 更安全（如 lib/mgmt-node-1.0.0.jar）。
• 调试技巧：
  1. 安装后先不启动，用 sc qc SGWJavaService 检查 BINARY_PATH_NAME 是否含未展开的 %SGW_HOME%；
  2. 启动失败时查看 WinSW 日志（默认 sgw.log 或 指定位置），搜索 java.io.FileNotFoundException；
  3. 临时添加 Manual 并用 WinSW-x64.exe start sgw.xml 手动触发，实时观察控制台输出。

? 替代方案：若必须动态构造 JAR 路径

当 lib/ 不在 SGW_HOME 下时，可借助批处理包装器：

<executable>%SGW_HOME%\bin\launch-sgw.bat</executable>
<arguments></arguments>

launch-sgw.bat 内容：

@echo off
java -jar "%SGW_HOME%\lib\mgmt-node-1.0.0.jar"

此方式将变量解析交给 CMD，100% 可靠，但增加一层进程开销。

综上，摒弃在 中直接写 %SGW_HOME%，转而利用 + 相对路径，是最简洁、健壮且符合 WinSW 设计意图的实践。配置完成后，重新安装并启动即可解决 Error 1067。