云海天狼先说我前几天经历的一件事。有个同事把Spring Boot服务打成Docker镜像推到测试环境，结果接口全部超时，应用日志时间比北京时间慢了整整8个小时。查了快一上午，最后发现根因不在代码，而在基础镜像默认时区是UTC，容器里根本没有Asia/Shanghai这道配置。那会儿我意识到一个问题：大部分人第一次接触"Spring Boot + Maven + Docker构建镜像"这件事时，默认"本地能跑，容器里就能跑"，可实际上从Maven仓库拉依赖、到Docker Desktop环境的准备、再到Dockerfile里每一行指令的语义，每一步都有大量藏在表面之下的细节。
这篇文章我就把从零到一构建Spring Boot Docker镜像的完整链路讲透，包括Maven在其中扮演的角色、环境准备的高频翻车点、四种主流构建方式的选型逻辑，以及我实际踩过的时区、缓存、镜像体积之类的坑。无论你是刚入门的Java开发，还是准备把项目容器化部署上线的后端工程师，照着这篇文章走一遍，至少能少走几天的弯路。
1. 先搞清楚构建链路：Maven、Jar包、Docker镜像三者怎么协作
很多初学者上来就找Dockerfile模板，复制粘贴完一跑，发现构建失败或者启动报错，根本不知道问题出在哪一层。原因就是对构建链路缺乏整体认知：一个Spring Boot项目要变成能运行的容器，中间其实隔着好几个阶段，每个阶段都有各自的职责。
1.1 为什么Spring Boot项目构建镜像绕不开Maven
Spring Boot项目本质上是一个Maven工程，pom.xml里管理了项目所有的依赖坐标。在生成镜像之前，Maven要完成编译、测试、依赖解析和打包等工作，最终产出一个可执行的Jar包。这个Jar包不是普通的依赖集合，而是Spring Boot特有的Fat Jar（胖Jar），里面内嵌了Tomcat等Web容器、所有第三方依赖和配置文件，通过java -jar就能直接启动。
正因为这样，Docker镜像的职责变得非常单一：它只需要提供一个能运行Jar包的JRE运行环境，把Jar包放进去，设置启动命令，然后把这个环境固化下来。所以构建链路的本质是三层协作：
- 源码层：Maven管理的Java工程，包括
src目录、pom.xml和资源文件。 - 产物层：Maven构建出来的可执行Jar包，也就是
target目录下那个后缀为.jar的文件。 - 镜像层：Docker基于某个基础镜像，叠加Jar包和启动参数，封装成可分发、可运行的镜像。
理解了这层协作关系，再看"构建镜像"这件事就清晰了：不管你用哪种方式，最终核心都是把Maven的构建产物，恰当地放进一个运行环境里。
1.2 手工构建与自动化构建的差异：Maven在其中扮演的角色
构建镜像可以分成两种模式。手工模式是最常见的入门姿势：先在本地执行mvn clean package把Jar包打出来，再在项目根目录写好Dockerfile，最后执行docker build -t myapp:v1 .得到镜像。这个流程里，Maven负责产Jar，Docker负责封装环境，两者的边界很清晰。
自动化模式则是把构建镜像这个动作绑定到Maven生命周期里，例如通过mvn package时自动触发Docker构建，或者直接使用mvn spring-boot:build-image这种官方插件。这种模式下Maven不再只是"打包工具"，它变成了构建流程的调度者，从源码编译到镜像产出一条命令搞定。
两种模式没有绝对的好坏，取决于你面临的环境。本地开发时手工模式更灵活，调试方便；CI/CD流水线里自动化模式更高效，因为构建动作可以被标准化的命令触发。这也是我在后面章节专门对比四种构建方式的原因，不同场景下最优解差异很大。
1.3 从源码到容器：镜像构建的完整节点
我把一条完整的构建链路拆开，大家对照着看，后续排查问题的时候就能快速定位是哪个节点出了问题：
- Maven解析
pom.xml，从仓库下载所有依赖，执行编译和单元测试。 mvn package产出可执行Jar包，Spring Boot Fat Jar内含内嵌Tomcat。- 编写Dockerfile，指定基础镜像（如
eclipse-temurin:11-jre）、拷贝Jar包、设置启动命令。 - Docker读取Dockerfile，拉取基础镜像并生成各层文件系统，最终组装成镜像。
docker run运行容器，映射端口，启动Spring Boot应用。
其中第1步到第2步是Maven的地盘，第3步到第5步是Docker的地盘。我见过很多人在第4步失败，报连接超时或仓库拉不到依赖，第一时间怀疑Docker配置，实际上问题出在第1步的Maven仓库源没配好。这种跨层级的排查经验，只有把全链路都理解透了才可能快速反应。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 动手前把环境理顺：Maven配置与Docker Desktop的高频翻车点
环境准备是新手最容易卡住的地方。热搜词里"maven下载""maven安装与配置""docker desktop安装教程""virtualization support not detected docker desktop failed to start"这些搜索记录已经说明了问题。我系统梳理一下两个核心环节的配置要点和排查思路。
2.1 Maven的settings.xml到底要配什么
Maven安装完之后，真正影响日常使用的不是mvn -v能输出版本号，而是conf/settings.xml这份全局配置文件。里面有两个关键项必须配置清楚。
第一个是本地仓库的位置。默认情况下Maven会把依赖