Windows环境下如何为Spring Boot应用构建Docker镜像？

前置检查 #

• 确认Windows端Docker Desktop已正确安装，且启用WSL2后端（Windows 10 2004及以上版本、Windows 11推荐配置），Docker服务处于正常运行状态
• 确认Spring Boot项目本地可正常打包为可执行jar包，IDE内运行无异常

核心配置文件编写 #

在项目根目录下新增如下两个文件：

1. Dockerfile #

# 基础镜像JDK版本需和项目使用的JDK版本完全一致，避免版本兼容问题
FROM openjdk:11-jre-slim
# 指定容器内工作目录
WORKDIR /app
# 复制本地打包好的jar包到容器内，将your-app-name.jar替换为实际生成的jar包文件名
COPY target/your-app-name.jar app.jar
# 暴露应用启动端口，替换为你项目实际使用的端口
EXPOSE 8080
# 容器启动执行命令
ENTRYPOINT ["java", "-jar", "app.jar"]

2. .dockerignore（可选，优化构建速度） #

.git
.idea
target
*.log
Dockerfile
.dockerignore

构建与运行步骤 #

1. 先在项目根目录执行打包命令，Maven项目执行mvn clean package -DskipTests，Gradle项目执行gradle bootJar，确认target目录下生成了可执行jar包
2. 打开PowerShell/终端，切换到项目根目录，执行镜像构建命令：
   docker build -t spring-boot-app:v1 .

注意命令末尾的小数点代表当前目录为构建上下文，不可省略

3. 镜像构建完成后执行容器启动命令，端口映射需和项目配置的端口保持一致：
   docker run -d -p 8080:8080 --name spring-boot-demo spring-boot-app:v1

常见问题排查 #

• 容器启动后访问失败时，执行docker logs 容器ID/容器名称查看启动日志，优先排查配置文件读取错误、端口冲突、依赖缺失类问题
• 路径相关报错需注意：Docker容器内为Linux路径规则，不要直接传入Windows盘符格式的路径
• 如需挂载外部配置文件、静态资源目录，可在启动命令中添加-v参数做目录映射，示例：docker run -d -p 8080:8080 -v D:/project/config:/app/config --name spring-boot-demo spring-boot-app:v1

内容的提问来源于stack exchange，提问作者Nice Dev