java项目docker化常见问题：配置未挂载导致application.yml找不到；depends_on不检查服务就绪需用wait-for-it.sh；日志缓冲需禁用logback异步；debug端口须绑定0.0.0.0并正确暴露。
Java项目启动时找不到application.yml，是因为Docker Compose没挂载对配置目录
很多Java开发者把src/main/resources/application.yml直接复制进镜像，结果在容器里改配置无效，或者环境切换失败。根本原因是Spring Boot默认只从classpath:和file:./config/、file:./加载配置，而Docker Compose默认不会自动映射本地配置目录到这些路径。
- 推荐做法：在
docker-compose.yml中用volumes显式挂载本地配置目录到容器的/app/config，再通过JAVA_OPTS指定-Dspring.config.location=file:/app/config/ - 避免把
application.ymlCOPY进Dockerfile——它会固化在镜像层，失去“一次构建、多环境运行”的优势 - 开发阶段建议保留
application-dev.yml在本地，通过spring.profiles.active=dev控制加载，而不是硬编码在镜像里
docker-compose.yml里depends_on不能保证Spring Boot应用等数据库就绪
depends_on只控制容器启动顺序，并不检查目标容器的服务端口是否真正可用。常见现象是Java服务启动报Connection refused，因为PostgreSQL容器虽已running，但PostgreSQL进程还没完成初始化。
- 正确做法：在Java服务的
command或启动脚本中加入健康检查逻辑，比如用wait-for-it.sh或dockerize - 示例片段（使用
wait-for-it.sh）：command: ["sh", "-c", "chmod +x /wait-for-it.sh && ./wait-for-it.sh postgres:5432 -- java -jar app.jar"]
- 别依赖
sleep 10这种固定延时——CI环境慢、本地环境快，不可靠
Java应用日志输出被Docker缓冲，docker-compose logs -f看不到实时日志
Spring Boot默认使用Logback，标准输出（stdout）会被Docker缓冲，导致docker-compose logs -f卡住或延迟数秒才刷出日志，调试体验极差。
- 必须在
application.yml中关闭Logback的异步和缓冲：logging: pattern: console: "%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n" level: root: INFO # 强制同步输出，禁用buffer file: max-size: 10MB # 关键：禁用logback的async appender和immediateFlush=false - 更彻底的方案：启动JVM时加
-Dlogback.debug=true确认实际生效的appender，或直接在logback-spring.xml里设置<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><immediateflush>true</immediateflush></appender> - 别在Dockerfile里用
ENTRYPOINT ["java", "-jar", "app.jar"]——它会绕过shell，导致stdout被全缓冲；改用ENTRYPOINT ["sh", "-c", "exec java -jar app.jar"]
本地IDE调试Java容器时，debug端口被Docker网络隔离
想用IDE远程调试容器里的Spring Boot应用，但docker-compose.yml里只暴露了5005端口，宿主机连不上，或者连上了却断点不触发。
立即学习“Java免费学习笔记（深入）”；
- 关键点：JVM debug参数必须绑定
0.0.0.0，不是127.0.0.1——后者在容器内只监听localhost，外部无法访问environment: - JAVA_OPTS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
- Docker Compose要同时做两件事：暴露端口+允许宿主机网络访问
ports: - "5005:5005" # 必须加这个，否则Docker Desktop on Mac/Win可能拦截 extra_hosts: - "host.docker.internal:host-gateway"
- IDE里调试配置的Host填
localhost，Port填5005，不要填容器IP——那只是Docker内部网络地址
Spring Boot容器化最常卡住的地方，不是语法或命令，而是“你以为的路径、端口、日志行为”和Docker实际执行的之间存在隐含偏差。每次怀疑配置不对，先docker-compose exec <service> ls -l /app/config</service>和netstat -tuln | grep 5005确认事实，比重读文档更快。
