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 和 com.ruoyi.RuoYiApplication 关键字识别，覆盖 jar、IDE、spring-boot:run 等常见启动方式
  • 启动时改为切换到 ruoyi-admin/ 目录后后台执行 mvn -DskipTests spring-boot:run
  • 启动日志统一落到仓库根目录 logs/backend-console.log
  • 启动后以前台 tail -F 持续输出控制台日志，便于直接查看
  • 保留 start、stop、restart、status 四个动作，便于和现有 ry.sh 使用习惯保持一致
• 新增 docs/tests/scripts/test-restart-java-backend.sh
  • 回归检查 spring-boot:run 是否在 ruoyi-admin 模块目录执行
  • 防止再次误从根聚合工程触发，导致 Unable to find a suitable main class

验证记录

• 执行 sh docs/tests/scripts/test-restart-java-backend.sh
  • 结果：通过，已校验 spring-boot:run 在 ruoyi-admin 模块目录执行
• 执行 sh -n bin/restart_java_backend.sh
  • 结果：通过，脚本语法正确
• 执行 sh bin/restart_java_backend.sh restart
  • 结果：通过，构建完成后在 ruoyi-admin 模块内触发 spring-boot:run
  • 关键日志：
    • Building ruoyi-admin 3.9.1
    • Starting RuoYiApplication
    • Started RuoYiApplication
• 执行 sh bin/restart_java_backend.sh stop
  • 结果：测试完成后已停止本次验证拉起的后端进程，避免残留端口占用

影响范围

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