Java项目Docker化核心是运行时行为与宿主机一致：需调整本地路径、localhost硬编码、JVM参数；Dockerfile注意JAVA_HOME、ENTRYPOINT/CMD、jar路径；推荐eclipse-temurin镜像；配置须外部化，用docker-compose统一管理依赖服务及健康检查。
Java项目用Docker运行，核心就三步：写好Dockerfile、构建镜像、启动容器
不是所有Java项目都适合直接扔进Docker——比如依赖本地文件系统路径、硬编码localhost:8080、或用System.setProperty动态改JVM参数的，不调整就跑不起来。关键不在“能不能打包”，而在“运行时行为是否和宿主机一致”。Dockerfile里最常出问题的是JAVA_HOME没设对、ENTRYPOINT和CMD混用导致命令不执行、或者把target/*.jar COPY错了路径。
- 推荐基础镜像用
eclipse-temurin:17-jre-jammy（轻量、安全更新及时），别用openjdk:17-jdk-slim再自己装curl或bash -
COPY命令要确认jar包在构建上下文里存在，常见错误是mvn clean package没先跑，或者Dockerfile放在src/下却想COPY根目录的target/app.jar - 启动命令统一用
ENTRYPOINT ["java", "-jar", "app.jar"]，别写RUN java -jar app.jar——后者只在构建阶段执行一次
Spring Boot项目暴露端口和配置必须外部化，不能靠application.properties硬编码
容器里localhost指的是容器自身，不是宿主机。所以Spring Boot默认的server.port=8080只是容器内监听，必须加EXPOSE 8080并在docker run时用-p 8080:8080映射，否则宿主机curl不通。更麻烦的是数据库地址——如果application.yml里写死url: jdbc:mysql://localhost:3306/mydb，容器启动后连的是它自己的127.0.0.1，不是你本机或另一个MySQL容器。
- 用
spring.profiles.active=docker激活独立配置，把数据库host改成服务名，例如jdbc:mysql://mysql:3306/mydb - 通过
docker run -e "SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/mydb"覆盖配置，优先级高于yml文件 - 避免在
Dockerfile里用ENV SPRING_PROFILES_ACTIVE=docker——这会让镜像失去环境适应性，应由运行时决定
docker-compose.yml才是Java开发环境的实际入口，单个docker run不够用
一个典型Java后端至少需要应用容器 + 数据库 + Redis，靠记一堆docker run参数没法协作。这时候docker-compose.yml不是可选项，是必需品。容易被忽略的是网络模式和健康检查：default网络下容器名自动变成DNS名，但如果你写了network_mode: host，服务间就无法用名字通信；另外没配healthcheck的话，Spring Boot还没启动完，Nginx或前端容器可能就去调用了，结果502。
- 数据库服务必须声明
restart: unless-stopped，否则docker-compose up失败时MySQL退出，Java应用反复重试连接直到超时 - Java服务的
depends_on只控制启动顺序，不等MySQL真正ready，得配合healthcheck和condition: service_healthy - 卷映射
volumes慎用于target/目录——宿主机和容器的编译输出冲突会导致类加载异常，建议只映射config/或logs/
version: '3.8'
services:
app:
build: .
ports: ["8080:8080"]
environment:
- SPRING_PROFILES_ACTIVE=docker
- SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/mydb
depends_on:
mysql:
condition: service_healthy
restart: on-failure
<p>mysql:
image: mysql:8.0
environment:</p><ul><li>MYSQL_ROOT_PASSWORD=root</li><li>MYSQL_DATABASE=mydb
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
timeout: 20s
retries: 10
volumes:</li><li>mysql-data:/var/lib/mysql</li></ul><p>volumes:
mysql-data:Java容器化真正的难点不在打包，而在于运行时依赖的解耦——数据库地址、配置中心地址、文件存储路径、时区、JVM内存参数，这些全得从代码里拎出来，交给Docker或Compose管理。少改一行application.yml，多写一个docker-compose.override.yml，比硬编码可靠得多。
立即学习“Java免费学习笔记（深入）”；
