SpringBoot项目Docker部署从零到一手把手全流程实战详解

前言

最近在实战部署Spring Boot后台管理系统时，遇到了几个隐蔽的难点，尤其是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，防止容器被宿主机OOM 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往往能有效绕过问题。

以上就是SpringBoot项目Docker部署全流程详解的详细内容。