Windows下Spring Boot服务化部署与WinSW实战

1. Windows下Spring Boot应用服务化部署实战

在企业级Java应用部署中，将Spring Boot的Jar包注册为Windows系统服务是个常见需求。不同于Linux系统可以通过systemd轻松管理服务，Windows环境需要借助第三方工具实现类似功能。经过多个生产环境项目的验证，WinSW(Windows Service Wrapper)以其稳定性和易用性成为我的首选方案。

提示：虽然Spring Boot官方提供了Maven插件支持Windows服务部署，但实际使用中发现WinSW在服务管理、日志记录和资源回收方面表现更为可靠。

1.1 工具选型考量

为什么选择WinSW而不是其他方案？这里有个实际项目中的对比案例：

去年部署某医疗HIS系统时，我们测试了三种方案：

1. 使用Spring Boot自带的spring-boot-maven-plugin服务部署功能
2. 通过NSSM(Non-Sucking Service Manager)注册服务
3. WinSW方案

测试结果如下表所示：

最终选择WinSW的关键因素在于其完善的日志轮转功能和稳定的进程管理机制。特别是在处理JVM内存泄漏问题时，WinSW能够确保服务异常退出后不会残留进程。

2. 详细部署流程解析

2.1 环境准备与工具配置

首先需要准备以下材料：

• 编译好的Spring Boot可执行Jar包（建议使用java -jar测试能正常启动）
• 匹配系统架构的WinSW可执行文件（x86或x64）
• 管理员权限的CMD窗口

关键细节：

1. 下载WinSW时务必核对文件哈希值，我遇到过下载被劫持导致服务异常的情况。推荐从GitHub官方仓库下载：

   bash复制# 推荐下载地址（示例版本，请替换为最新）
   https://github.com/winsw/winsw/releases/download/v2.11.0/WinSW-x64.exe
   

2. 重命名规则有讲究：必须保持.exe、.xml与Jar包主文件名一致。比如：

   code复制app-service.jar  # 原始Jar包
   app-service.exe  # WinSW重命名后
   app-service.xml  # 配置文件
   

2.2 配置文件深度优化

基础配置如文中所示，但在生产环境中还需要考虑以下增强配置：

xml复制<service>
  <id>his-server</id>
  <name>HIS Spring Boot Server</name>
  <description>HIS系统服务(v2.3.0)</description>
  
  <!-- 重要：使用绝对路径避免权限问题 -->
  <executable>C:\Program Files\Java\jdk-17\bin\java.exe</executable>
  
  <!-- 增强版启动参数 -->
  <arguments>
    -server
    -Xms2048m -Xmx2048m
    -XX:+UseG1GC
    -XX:+HeapDumpOnOutOfMemoryError
    -XX:HeapDumpPath=D:\his-server\dumps
    -jar "D:\his-server\his-server.jar"
    --spring.profiles.active=prod
    --server.port=8443
  </arguments>

  <!-- 服务失败自动重启配置 -->
  <onfailure action="restart" delay="60 sec"/>
  
  <!-- 环境变量配置 -->
  <env name="TZ" value="Asia/Shanghai"/>
  <env name="JAVA_TOOL_OPTIONS" value="-Dfile.encoding=UTF-8"/>
  
  <!-- 高级日志配置 -->
  <logpath>D:\his-server\logs</logpath>
  <logmode>rotate</logmode>
  <logname>his-server-%YYYY%-%MM%-%DD%.log</logname>
  <maxlogsize>10240</maxlogsize>
  <maxlogfiles>10</maxlogfiles>
  
  <!-- 服务健康检查 -->
  <serviceaccount type="LocalSystem">
    <allowservicelogon>true</allowservicelogon>
  </serviceaccount>
  <waithint>15</waithint>
  <sleeptime>5</sleeptime>
</service>

配置要点说明：

1. JVM参数配置：生产环境必须配置内存限制和GC策略，避免系统资源耗尽
2. 日志轮转：设置maxlogsize防止日志文件无限增长（单位KB）
3. 服务账户：使用LocalSystem账户可避免权限问题，但安全性要求高的场景应使用专用账户

2.3 服务注册与管理

安装过程有几个易错点需要注意：

bash复制# 必须使用管理员权限运行CMD
cd /d D:\his-server

# 安装服务（会生成.events.log文件）
his-server.exe install

# 启动服务（首次启动建议观察日志）
his-server.exe start

# 查看状态（返回ExitCode表示运行状态）
his-server.exe status

重要提示：如果安装后服务无法启动，先检查Windows事件查看器中的应用程序日志，WinSW的错误信息通常记录在那里。

3. 生产环境进阶配置

3.1 服务健康检查机制

为确保服务持续可用，建议添加健康检查脚本。创建一个healthcheck.bat：

bat复制@echo off
set SERVICE_URL=http://localhost:8443/actuator/health
set CURL_PATH="C:\Windows\System32\curl.exe"

%CURL_PATH% --max-time 5 --silent --show-error %SERVICE_URL% | findstr "\"status\":\"UP\"" >nul
if %ERRORLEVEL% equ 0 (
    exit 0
) else (
    exit 1
)

然后在XML配置中添加：

xml复制<!-- 健康检查配置 -->
<healthcheck>
  <executable>D:\his-server\healthcheck.bat</executable>
  <arguments></arguments>
  <interval>60</interval>
  <timeout>10</timeout>
</healthcheck>

3.2 多实例部署方案

当需要部署多个相同服务实例时，推荐以下目录结构：

code复制D:\services\
├── instance1\
│   ├── app.jar
│   ├── app.exe
│   └── app.xml
└── instance2\
    ├── app.jar
    ├── app.exe
    └── app.xml

对应的服务ID需要区分：

xml复制<!-- 实例1配置 -->
<id>app-instance1</id>

<!-- 实例2配置 -->  
<id>app-instance2</id>

3.3 服务更新策略

更新服务时推荐流程：

1. 停止旧服务：his-server.exe stop
2. 卸载服务：his-server.exe uninstall
3. 替换Jar包和配置文件
4. 重新安装：his-server.exe install
5. 启动服务：his-server.exe start

经验分享：直接覆盖运行中的Jar文件可能导致类加载异常，务必先停止服务。

4. 故障排查手册

4.1 常见问题速查表

4.2 日志分析技巧

WinSW会生成三种日志文件：

1. .wrapper.log - WinSW自身运行日志
2. .out.log - 应用标准输出日志
3. .err.log - 应用错误日志

分析顺序建议：

1. 首先检查.wrapper.log看服务是否正常启动
2. 如果wrapper日志正常但应用未运行，检查.err.log
3. 内存问题查看.out.log中的GC日志

4.3 性能优化建议

对于高并发应用，推荐以下JVM优化参数：

xml复制<arguments>
  -server
  -Xms4096m -Xmx4096m
  -XX:+UseG1GC
  -XX:MaxGCPauseMillis=200
  -XX:ParallelGCThreads=4
  -XX:ConcGCThreads=2
  -XX:+AlwaysPreTouch
  -jar "D:\his-server\his-server.jar"
</arguments>

5. 服务监控与维护

5.1 集成Prometheus监控

在application.properties中添加：

properties复制management.endpoints.web.exposure.include=health,info,prometheus
management.metrics.export.prometheus.enabled=true

然后配置WinSW的healthcheck指向/actuator/prometheus端点。

5.2 日志集中管理

推荐使用logback-spring.xml配置日志，与WinSW的日志配置配合：

xml复制<configuration>
    <property name="LOG_PATH" value="D:/his-server/logs"/>
    <property name="LOG_FILE" value="${LOG_PATH}/app.log"/>
    
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_FILE}</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/app-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <maxFileSize>10MB</maxFileSize>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
</configuration>

5.3 服务备份策略

建议创建批处理脚本定期备份服务配置：

bat复制@echo off
set BACKUP_DIR=D:\backups\his-server
set SOURCE_DIR=D:\his-server

mkdir %BACKUP_DIR%\%date:~0,4%-%date:~5,2%-%date:~8,2%

xcopy %SOURCE_DIR%\*.jar %BACKUP_DIR%\%date:~0,4%-%date:~5,2%-%date:~8,2%\ /Y
xcopy %SOURCE_DIR%\*.xml %BACKUP_DIR%\%date:~0,4%-%date:~5,2%-%date:~8,2%\ /Y

将这个脚本加入Windows任务计划，每周执行一次。