Docker容器中Spring Boot应用无法连接PostgreSQL的问题

第一阶段：容器内连接本地PostgreSQL失败 #

问题原因 #

Docker容器中的localhost指向容器自身网络空间，而非宿主机，因此应用无法通过localhost访问宿主机上的PostgreSQL服务。

解决方案 #

提供三种可行方案，按需选择：

• 方案1：使用宿主机实际IP
  将application.properties中的数据库URL替换为宿主机的局域网IP（如192.168.3.10）：

  spring.datasource.url= jdbc:postgresql://192.168.3.10:5432/TechDB
  spring.datasource.username= myuser
  spring.datasource.password= mypass
  

  重新构建镜像并启动容器即可。

• 方案2：共享宿主机网络
  启动容器时添加--network host参数，让容器直接使用宿主机网络：

  docker run --network host -p 8000:8080 apptotest
  

  此时容器内的localhost等价于宿主机的localhost，无需修改配置文件。

• 方案3：使用Docker内置DNS（仅Windows/macOS）
  Docker为Windows/macOS提供了特殊DNS名称host.docker.internal，可直接映射到宿主机：

  spring.datasource.url= jdbc:postgresql://host.docker.internal:5432/TechDB
  spring.datasource.username= myuser
  spring.datasource.password= mypass
  

第二阶段：docker-compose部署后Spring Boot应用未启动 #

问题根源 #

1. 镜像混淆：你将原Spring Boot的Dockerfile替换为PostgreSQL的Dockerfile，导致apptotest镜像实际是PostgreSQL镜像，运行docker run apptotest启动的是另一个数据库容器而非Spring Boot应用。
2. 配置语法错误：docker-compose.yml中volumes节点缩进错误，不符合YAML语法规范。
3. 启动命令参数错误：docker run命令中--name apptotest--network缺少空格，导致参数解析失败。

修复步骤 #

1. 分离Dockerfile，重新构建应用镜像

创建两个独立的Dockerfile，避免镜像覆盖：

• Spring Boot应用Dockerfile（命名为Dockerfile-app）：

  FROM openjdk:22
  LABEL maintainer="myself"
  ADD target/AppToTest-1.0-SNAPSHOT.jar AppToTest.jar
  ENTRYPOINT ["java", "-jar", "AppToTest.jar"]
  

• PostgreSQL数据库Dockerfile（命名为Dockerfile-db）：

  FROM postgres:15.1-alpine
  COPY *.sql /docker-entrypoint-initdb.d/
  

  重新构建Spring Boot应用镜像：

  docker build -f Dockerfile-app -t apptotest:latest .
  

2. 修正docker-compose.yml配置

将Spring Boot服务加入compose，自动管理网络和依赖关系，修正后的配置如下：

services:
  postgres:
    build:
      context: .
      dockerfile: Dockerfile-db
    container_name: "my-postgres"
    environment:
      POSTGRES_DB: "newdb"
      POSTGRES_USER: "postgres"
      POSTGRES_PASSWORD: "password"
      POSTGRES_HOST_AUTH_METHOD: "trust"
      PGDATA: "/data/newdb"
    volumes:
       - newdb:/data/newdb
    ports:
       - "5432:5432"
    restart: unless-stopped
  apptotest:
    image: apptotest:latest
    container_name: "my-spring-app"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/newdb
      SPRING_DATASOURCE_USERNAME: postgres
      SPRING_DATASOURCE_PASSWORD: password
    ports:
       - "8000:8080"
    depends_on:
       - postgres
    restart: unless-stopped
volumes:
  newdb:
    external: true

3. 启动所有服务

确保已创建外部卷：

docker volume create newdb

直接通过compose启动服务：

docker-compose up -d

4. 排查启动问题

若应用仍未启动，查看Spring Boot容器日志定位错误：

docker logs my-spring-app

常见问题包括数据库未就绪导致连接超时，可添加启动等待逻辑（如使用wait-for-it脚本）或调整Spring Boot的数据库连接超时配置。

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