loan-pricing/doc/2026-04-13-tongweb-replace-tomcat-backend-plan.md

东方通替换 Tomcat 后端实施计划

目标

• 将后端交付形态从内嵌 Tomcat 的 jar 调整为部署到东方通 TongWeb 的 war
• 清理当前发布链路中围绕 java -jar / ruoyi-admin.jar 的脚本约定
• 保持现有前端发布方式和 Nginx 入口不变，后端仍沿用 63310 作为反向代理目标端口

改动范围

• Maven 构建
  • 调整 ruoyi-admin 打包类型为 war
  • 去除模块链路中的嵌入式 Tomcat 打包依赖
  • 明确 Servlet API 由外部容器提供
• 部署脚本
  • 将生产部署脚本中的后端产物从 ruoyi-admin.jar 切换为 ruoyi-admin.war
  • 将生产重启脚本从 Java 进程启停改为 TongWeb 容器启停与 war 发布
  • 调整本地后端重启脚本，使其面向 TongWeb 进行构建和部署
• 运行文档
  • 更新本地安装手册中的后端环境说明，改为 TongWeb
  • 新增本次改动实施记录

实施步骤

1. 先修改现有脚本测试，明确新的 war + TongWeb 约束
2. 调整 Maven 配置，产出 ruoyi-admin.war
3. 修改生产部署脚本和本地重启脚本
4. 更新运行文档与实施记录
5. 执行脚本测试、语法校验和 Maven 打包验证

验证要求

• mvn -pl ruoyi-admin -am clean package -DskipTests 成功，且产物为 ruoyi-admin.war
• sh bin/prod/restart_java_test.sh 成功
• sh bin/prod/deploy_from_package_test.sh 成功
• sh bin/restart_java_backend_test.sh 成功
• sh -n bin/prod/restart_java.sh
• sh -n bin/prod/deploy_from_package.sh
• sh -n bin/restart_java_backend.sh