【安装配置教程】Spring Boot 项目 Docker 部署全流程详解

前言

最近在部署一个基于 Spring Boot 的后台管理系统到 Linux 服务器，采用了 Docker 容器化部署的方式。虽然 Docker 部署已经是主流，但在实际操作中，特别是涉及定时任务框架 Quartz 的数据库表结构初始化时，还是遇到了一些比较隐蔽的“坑”。
本文将复盘整个部署流程，从 JAR 包准备、Dockerfile 编写到容器启动、故障排查进行完整记录，希望能帮助大家避坑。

一、 准备工作：配置与环境

在打 JAR 包之前，最重要的一步是修改配置文件以适配生产环境。很多同学习惯在本地用 localhost 开发，如果直接打包丢到服务器，容器内是找不到 localhost 的数据库的。

1. 修改数据库与中间件连接

进入 application-prod.yml（或 application.yml），重点检查以下配置：

• 数据库 URL：将 localhost 修改为服务器真实的 IP 地址或数据库服务地址。
• Redis 地址：同上，修改为真实 IP。
• 文件上传路径：确保路径为 Linux 格式（如 /app/upload），避免使用 Windows 路径（C:/upload）。

2. 打包项目

在项目根目录执行 Maven 命令：

mvn clean package

打包成功后，在 target 目录下找到 myproject-admin.jar（本文以此命名）。

二、 编写 Dockerfile

将 JAR 包上传到服务器（如 /opt/docker/myproject/）目录下，并在同目录下创建 Dockerfile 文件。

Dockerfile 内容详解

# 1. 指定基础镜像
# 这里选用 Eclipse Temurin (JDK 17) 的 Alpine 版本，体积小，安全性好
FROM eclipse-temurin:17-jre-alpine
# 2. 设置工作目录
WORKDIR /app
# 3. 解决时区问题 (关键步骤)
# Alpine 镜像默认时区是 UTC，需要安装 tzdata 并配置为上海时区
# 利用 Docker 缓存机制，将系统依赖安装放在 COPY 之前
RUN apk add --no-cache tzdata && \
    cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    echo "Asia/Shanghai" > /etc/timezone && \
    apk del tzdata
# 4. 拷贝 JAR 包
COPY myproject-admin.jar .
# 5. 声明服务端口
EXPOSE 8080
# 6. 配置 JVM 参数
# -Xms/Xmx: 限制堆内存，防止容器 OOM
# -Djava.security.egd: 解决 Linux 下随机数生成阻塞导致启动慢的问题
ENV JAVA_OPTS="-Xms512m -Xmx1024m -Djava.security.egd=file:/dev/./urandom"
# 7. 启动命令
# 使用 sh -c 启动是为了让环境变量 $JAVA_OPTS 生效
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar myproject-admin.jar"]

---

三、 构建与运行

1. 构建镜像

在 JAR 包所在目录执行：

docker build -t myproject-server:1.0 .

看到 Successfully built 和 Successfully tagged 提示即表示构建成功。

2. 启动容器（生产推荐配置）

docker run -d \
  --name myproject-app \
  -p 8080:8080 \
  -m 1.5g \
  --cpus 1 \
  --restart=on-failure:5 \
  -v /home/myproject/logs:/app/logs \
  myproject-server:1.0

参数解释：

• -d: 后台运行。
• -m 1.5g: 限制容器最大内存。JVM 堆内存设置了 1G，给元空间等预留 500M，防止容器被宿主机 Kill。
• --restart=on-failure:5: 容器异常退出时自动重启，增强健壮性。
• -v: 挂载日志目录，方便在宿主机直接查看日志。

---

四、 踩坑实录：Quartz 表结构问题

1. 问题现象

容器启动瞬间报错，通过 docker logs -f myproject-app 查看日志，发现如下错误：

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sysJobServiceImpl': ...
Caused by: org.quartz.impl.jdbcjobstore.LockException: Failure obtaining db row lock: Table 'db_name.QRTZ_LOCKS' doesn't exist

原因分析：
项目集用了 Quartz 定时任务框架，且配置了 JDBC 模式持久化。但数据库中缺少了 Quartz 所需的标准表结构（QRTZ_ 开头的表）。

2. 尝试解决与报错

找到项目中的 sql/quartz.sql 脚本并导入，结果执行时报错：

ERROR 1826 (HY000): Duplicate foreign key constraint name 'QRTZ_TRIGGERS_ibfk_1'
ERROR 1824 (HY000): Failed to open the referenced table 'QRTZ_TRIGGERS'

这是因为脚本中的表之间存在外键依赖，且数据库中可能残留了之前的元数据，导致脚本执行中断。

3. 最终解决方案

核心思路：先关闭外键检查，再手动逐表创建（或使用不含外键的建表语句）。
在 MySQL 客户端执行以下 SQL（已去除可能导致报错的外键约束，确保能跑通）：

-- 1. 清理环境
SET FOREIGN_KEY_CHECKS = 0;
DROP TABLE IF EXISTS QRTZ_FIRED_TRIGGERS;
DROP TABLE IF EXISTS QRTZ_PAUSED_TRIGGER_GRPS;
DROP TABLE IF EXISTS QRTZ_SCHEDULER_STATE;
DROP TABLE IF EXISTS QRTZ_LOCKS;
DROP TABLE IF EXISTS QRTZ_SIMPLE_TRIGGERS;
DROP TABLE IF EXISTS QRTZ_SIMPROP_TRIGGERS;
DROP TABLE IF EXISTS QRTZ_CRON_TRIGGERS;
DROP TABLE IF EXISTS QRTZ_BLOB_TRIGGERS;
DROP TABLE IF EXISTS QRTZ_TRIGGERS;
DROP TABLE IF EXISTS QRTZ_JOB_DETAILS;
DROP TABLE IF EXISTS QRTZ_CALENDARS;
-- 2. 建表语句（省略具体字段，请参考 Quartz 官方 SQL）
CREATE TABLE QRTZ_JOB_DETAILS (...) ENGINE=InnoDB;
CREATE TABLE QRTZ_TRIGGERS (...) ENGINE=InnoDB;
CREATE TABLE QRTZ_SIMPLE_TRIGGERS (...) ENGINE=InnoDB;
-- ... 其他表 ...
-- 3. 恢复检查
SET FOREIGN_KEY_CHECKS = 1;

执行成功后，重启容器：

docker restart myproject-app

服务成功启动，日志显示 Started Application。

五、 常用运维命令

部署完成后，记录几个高频使用的运维命令：

• 查看实时日志：

  docker logs -f myproject-app
  

• 进入容器内部排查（Alpine 镜像用 sh）：

  docker exec -it myproject-app sh
  

• 复制容器内文件到宿主机：

  docker cp myproject-app:/app/logs/sys-info.log /home/
  

---

六、 总结

Docker 部署 Java 应用虽然简单，但细节决定成败：

1. 配置文件一定要在打包前检查（数据库 IP、端口）。
2. 数据库表结构要完整，尤其是像 Quartz 这种需要持久化的框架。
3. 遇到 MySQL 外键报错时，使用 SET FOREIGN_KEY_CHECKS = 0 往往能通过。
   希望这篇笔记对你有所帮助！如有问题，欢迎在评论区交流哦~