ccdi/docs/plans/backend/2026-03-19-java-backend-restart-script-backend-implementation.md

# Java后端一键重启脚本实施记录

## 修改目标

- 新增一个可直接在仓库内执行的后端重启脚本
- 脚本需支持重启前自动执行 `mvn -pl ruoyi-admin -am clean package -DskipTests`
- 重启完成后持续输出后端运行日志，便于直接观察启动结果和后续日志

## 修改内容

- 新增 `bin/restart_java_backend.sh`
  - 默认执行 `restart` 动作，无参即可触发一键重启
  - 重启流程固定为“先构建，后停机，再启动”
  - 停机时同时兼容端口 `62318` 和 `ruoyi-admin.jar` 关键字识别
  - 启动时改为参考 `bin/run.bat`，切换到 `ruoyi-admin/target/` 后后台执行 `java -jar ruoyi-admin.jar`
  - 启动日志统一落到仓库根目录 `logs/backend-console.log`
  - 启动后以前台 `tail -F` 持续输出控制台日志，便于直接查看
  - 保留 `start`、`stop`、`restart`、`status` 四个动作，便于和现有 `ry.sh` 使用习惯保持一致
- 新增 `docs/tests/scripts/test-restart-java-backend.sh`
  - 回归检查脚本是否切换到 `ruoyi-admin/target` 并使用 `java -jar ruoyi-admin.jar` 启动
  - 防止后续再次回退到 `spring-boot:run` 启动链路

## 验证记录

- 执行 `sh docs/tests/scripts/test-restart-java-backend.sh`
  - 结果：通过，已校验脚本使用 `java -jar` 启动打包产物
- 执行 `sh -n bin/restart_java_backend.sh`
  - 结果：通过，脚本语法正确
- 执行 `sh bin/restart_java_backend.sh restart`
  - 结果：通过，构建完成后在 `ruoyi-admin/target` 内触发 `java -jar ruoyi-admin.jar`
  - 关键日志：
    - `Starting RuoYiApplication using Java 21.0.9 with PID ... (/Users/wkc/Desktop/ccdi/ccdi/ruoyi-admin/target/ruoyi-admin.jar started by wkc in /Users/wkc/Desktop/ccdi/ccdi/ruoyi-admin/target)`
    - `Started RuoYiApplication in 7.457 seconds`
  - 进程核验：
    - `java -Duser.timezone=Asia/Shanghai -Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -jar ruoyi-admin.jar`
- 执行 `sh bin/restart_java_backend.sh stop`
  - 结果：测试完成后已停止本次验证拉起的后端进程，避免残留端口占用

## 影响范围

- 新增本地运维辅助脚本，不修改现有 Java 业务代码
- 日志新增输出文件：`logs/backend-console.log`
- 不影响前端、数据库和 Mock 服务逻辑