部署
常规部署形态:jar + MySQL + 反向代理。本站不提供容器镜像与编排文件。
说明:本页只覆盖常规(非容器化)部署:JDK + jar + MySQL + 反向代理。容器镜像与编排文件不在文档范围内,需要时请按你们自己的运维规范封装。
构建产物
./gradlew clean build
ls build/libs/
build 会跑完全部测试与守护规则,产物只有一个可执行 jar。
运行前置
| 项 | 要求 |
|---|---|
| JDK | 21(与构建同版本) |
| 数据库 | MySQL 8.0+,库与账号提前建好 |
| 环境变量 | 与 .env.example 完全对应,缺一即启动失败 |
| 目录 | 日志目录与上传目录需可写,路径走配置项不写死 |
启动
java -jar minimao.jar --spring.profiles.active=prod
生产环境建议交给进程管理器托管(systemd / supervisor / Windows 服务任选),核心要求是退出能自动拉起与日志可落盘,与框架无关。
反向代理与健康检查
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
- 健康检查走应用自身的健康端点,不要自建
/pingController(会绕过鉴权默认拒绝)。 - 上传文件大小限制要同时配置网关与应用两处,服务端白名单是最后一道。
升级与回滚
- 先备份数据库——迁移脚本只增不改,但备份仍是回滚的唯一保险。
- 停服,保留旧包(回滚就是换回旧包)。
- 换包启动,观察迁移日志是否全部执行成功。
- 启动失败立即换回旧包并恢复备份,不要在运行中改脚本。
提示:跨版本升级不改动业务代码:定制留在你的业务仓,核心仓升级只影响核心。
最后更新 2026-10-09编辑此页 →