Spring Boot Docker容器连接PostgreSQL被拒绝问题求助

核心错误原因 #

1. 容器内localhost指向自身而非宿主机：你在Spring Boot配置里写的localhost:5332，在容器环境中是指应用容器自己的网络，而非运行PostgreSQL的宿主机或PostgreSQL容器，因此连接会被拒绝。
2. Dockerfile中无法执行docker-compose：Docker镜像构建阶段（Dockerfile执行时）的环境不包含docker-compose工具，且Dockerfile的作用是构建镜像，而非编排容器，不能在其中调用docker-compose命令。

分步解决方案 #

1. 修正Spring Boot数据库连接配置 #

根据你的部署场景二选一修改配置文件（application.properties或application.yml）：

• 连接宿主机上已运行的PostgreSQL容器：

  # application.properties
  spring.datasource.url=jdbc:postgresql://host.docker.internal:5332/irrigation
  spring.datasource.username=你的数据库用户名
  spring.datasource.password=你的数据库密码
  spring.jpa.hibernate.ddl-auto=none # 依赖import.sql建表，禁用Hibernate自动生成
  spring.sql.init.mode=always # 确保启动时执行import.sql
  

  host.docker.internal是Docker提供的特殊域名，用于容器访问宿主机网络，Linux、Windows、macOS均支持。如果该域名无效，可直接替换为宿主机的实际IP（如192.168.1.100）。

• 与PostgreSQL容器同属一个Docker网络（推荐）：
  配置中数据库地址改为PostgreSQL容器的服务名（如postgres），端口用容器内部的5432，后续通过docker-compose编排时会自动解析域名。

2. 自动创建irrigation数据库 #

通过PostgreSQL容器的初始化脚本实现自动建库：

1. 在项目根目录创建db-init文件夹，新建init.sql文件：

   CREATE DATABASE IF NOT EXISTS irrigation;
   

2. 若用docker-compose管理PostgreSQL容器，在配置中挂载该脚本：

   services:
     postgres:
       image: postgres:15
       environment:
         POSTGRES_USER: 你的用户名
         POSTGRES_PASSWORD: 你的密码
       ports:
         - "5332:5432"
       volumes:
         - ./db-init/init.sql:/docker-entrypoint-initdb.d/init.sql
         - postgres-data:/var/lib/postgresql/data # 持久化数据库数据
   

   PostgreSQL容器启动时，会自动执行/docker-entrypoint-initdb.d/目录下的所有SQL脚本，完成irrigation数据库的创建。

3. 正确容器化Spring Boot应用 #

编写多阶段构建的Dockerfile（优化镜像大小）

# 构建阶段：编译打包应用
FROM maven:3.9-eclipse-temurin-20 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn clean package -DskipTests

# 运行阶段：仅保留运行所需环境
FROM eclipse-temurin-20-jre-slim
WORKDIR /app
COPY --from=builder /app/target/你的应用jar包名称.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

替换你的应用jar包名称.jar为实际的jar文件名（可在pom.xml中通过<finalName>固定名称）。

用docker-compose编排应用与数据库（实现自给自足）

创建docker-compose.yml，同时管理Spring Boot应用和PostgreSQL容器：

version: '3.8'

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_USER: dbuser
      POSTGRES_PASSWORD: dbpass
    ports:
      - "5332:5432"
    volumes:
      - ./db-init/init.sql:/docker-entrypoint-initdb.d/init.sql
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U dbuser -d irrigation"]
      interval: 5s
      timeout: 5s
      retries: 5

  spring-app:
    build: .
    ports:
      - "8080:8080"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/irrigation
      SPRING_DATASOURCE_USERNAME: dbuser
      SPRING_DATASOURCE_PASSWORD: dbpass
      SPRING_SQL_INIT_MODE: always
    depends_on:
      postgres:
        condition: service_healthy

说明：

• depends_on配合healthcheck确保PostgreSQL完全启动后再启动Spring Boot应用，避免因数据库未就绪导致的连接失败。
• 应用容器通过服务名postgres访问数据库容器，无需依赖宿主机网络即可通信，同时对外暴露5332和8080端口满足外部访问需求。

4. 启动与测试 #

执行以下命令构建并启动容器：

docker-compose up --build

启动完成后，用Postman访问localhost:8080的API，验证是否正常连接数据库并返回数据。

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