容器化Spring Boot应用无法从Docker外部访问问题排查

问题分析 #

本地运行Spring Boot v3.2.4应用可通过localhost:8080正常访问，但容器启动后无法通过localhost:8832访问，且Docker日志无Tomcat启动记录，大概率是应用未成功启动，或网络/配置存在问题。

排查与解决步骤 #

1. 查看容器完整启动日志 #

先确认应用启动时是否有报错，执行以下命令查看实时日志：

docker-compose logs -f quiz-app

重点关注是否有数据库连接失败、jar包启动异常等错误信息——比如depends_on仅保证PostgreSQL容器先启动，不保证数据库服务已就绪，应用启动时可能因无法连接DB而崩溃。

2. 验证容器内应用状态 #

进入容器内部，检查应用是否真的在运行：

docker-compose exec quiz-app sh

在容器内执行以下操作：

• 查看Java进程：ps aux | grep java，若无相关进程，说明应用未启动。
• 测试容器内访问：curl localhost:8080，若无法访问，确认应用本身启动失败。

3. 检查Spring Boot核心配置 #

确保应用监听正确的网络地址与端口：

• 检查application.properties或application.yml，确认：

  server.port=8080
  server.address=0.0.0.0
  

  server.address=0.0.0.0是关键，若仅绑定localhost，容器外部无法访问应用。

4. 修复数据库连接就绪问题 #

PostgreSQL容器启动后需要几秒时间才能接受连接，可通过以下方式解决：

• 添加数据库连接重试配置：在Spring Boot配置文件中增加：

  spring.datasource.hikari.connection-timeout=20000
  spring.datasource.hikari.maximum-pool-size=5
  spring.datasource.hikari.connection-test-query=SELECT 1
  spring.datasource.hikari.validation-timeout=5000
  

• 使用等待脚本：修改docker-compose.yml的command，等待数据库就绪再启动应用（需提前将wait-for-it.sh放入项目目录）：

  services:
    quiz-app:
      # ... 其他配置
      command: ["./wait-for-it.sh", "db:5432", "--", "java", "-jar", "/app.jar"]
  

5. 检查Docker构建与配置问题 #

• 确认jar包路径正确：执行构建命令并检查是否有复制错误：

  docker-compose build --no-cache quiz-app
  

  确保out/artifacts/quizGemini_jar/quizGemini.jar在构建上下文（当前目录）下存在，COPY命令无失败提示。
• 清理冗余配置：Dockerfile中的EXPOSE 8832和docker-compose.yml中的expose: -8832是冗余的，因为应用实际监听8080，端口映射已通过ports: "8832:8080"完成，可删除这些不影响功能的配置。

内容的提问来源于stack exchange，提问作者Umut Savas