Spring Boot应用启动时随机卡住问题排查求助

1. 解决Postgres容器未就绪导致的应用启动阻塞 #

depends_on仅能保证Postgres容器启动，无法确保数据库服务已完全就绪（比如完成初始化、可接受连接）。应用启动时尝试连接未就绪的数据库，会因连接超时卡住。

修复方案： #

给Postgres服务添加健康检查，确保数据库就绪后再启动应用：
修改docker-compose.yml中postgres服务的配置：

postgres:
  image: postgis:11-alpine
  command: postgres -c stats_temp_directory=/tmp
  ports:
    - 5432:5432
  environment:
    - POSTGRES_PASSWORD=password!
    - POSTGRES_USER=xxx
    - POSTGRES_DB=xxx
  volumes:
    - ./postgres-data:/var/lib/postgresql/data
  networks:
    xxx-network:
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U xxx -d xxx"]
    interval: 5s
    timeout: 5s
    retries: 5

同时更新应用服务的depends_on，依赖Postgres的健康状态：

fargate-xxx:
  depends_on:
    postgres:
      condition: service_healthy
  # 其他配置保持不变

2. 解决M1芯片的架构兼容性问题 #

PostGIS 11-alpine镜像可能仅支持x86架构，而M1芯片为arm64架构，容器运行时的兼容性问题可能导致Postgres服务异常，进而让应用连接卡住。

修复方案： #

• 方案一：指定容器运行平台为x86_64：
  在postgres服务中添加platform配置：

  postgres:
    image: postgis:11-alpine
    platform: linux/amd64
    # 其他配置保持不变
  

• 方案二：更换支持arm64架构的PostGIS镜像，比如postgis/postgis:11-alpine（需确认镜像官方支持arm64）。

3. 排除调试参数干扰 #

虽然JAVA_OPTS中设置了suspend=n，但调试端口的配置可能存在潜在问题，导致应用启动流程阻塞。

修复方案： #

临时移除JAVA_OPTS中的调试参数，重新启动应用观察是否正常：
修改docker-compose.yml中应用服务的环境变量：

environment:
  ENVIRONMENT: ${ENVIRONMENT}
  # 注释或删除调试配置
  # JAVA_OPTS: -Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n

若应用能正常启动，可改用JDK 11+推荐的调试参数格式重新配置：

JAVA_OPTS: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000

4. 验证数据库连接配置 #

确认应用的数据库连接配置是否正确：

• 数据库URL应为jdbc:postgresql://postgres:5432/xxx（使用docker-compose中的服务名作为主机地址）
• 用户名、密码需与docker-compose中Postgres的POSTGRES_USER、POSTGRES_PASSWORD完全一致
• 检查是否有防火墙或网络策略阻止应用容器访问Postgres容器

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