Testcontainer中Spring Boot应用连接PostgreSQL数据库失败排查

核心问题分析 #

Mac环境里，Docker容器的localhost指向容器自身而非宿主机。你遇到的Connection refused: localhost/127.0.0.1:52801错误，本质是AccountService容器内的数据库连接配置用了localhost，导致它尝试连接容器自身的52801端口，而非宿主机上的PostgreSQL服务。

具体解决步骤 #

1. 替换容器内的数据库连接地址 #

把AccountService的数据库连接地址从localhost改成Mac宿主机的Docker专属别名host.docker.internal。这个别名是Docker for Mac官方提供的，用于容器直接访问宿主机服务。

• 原配置示例：jdbc:postgresql://localhost:52801/account_db
• 修改后：jdbc:postgresql://host.docker.internal:52801/account_db

2. 统一Testcontainers容器网络（若PostgreSQL也是容器） #

如果你的PostgreSQL是用Testcontainers启动的容器，必须让AccountService和PostgreSQL容器处于同一Docker网络：

@Container
private static final PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:14")
        .withNetworkAliases("postgres-db")
        .withNetwork(DockerNetwork.builder().createNetworkParams(create -> create.withName("test-network")).build());

@Container
private static final GenericContainer<?> accountService = new GenericContainer<>(DockerImageName.parse("your-account-service-image"))
        .withNetwork(postgres.getNetwork())
        .withEnv("DB_URL", "jdbc:postgresql://postgres-db:5432/account_db");

这里用postgres-db作为PostgreSQL容器的网络别名，AccountService通过别名直接访问同网络内的数据库，无需依赖宿主机地址。

3. 检查端口转发与占用情况 #

• 打开Docker Desktop → Settings → Resources → Network，确认52801端口无冲突且已正确转发
• 用lsof -i :52801命令验证宿主机的52801端口确实被PostgreSQL占用

4. 确保Dockerfile支持动态配置 #

检查AccountService的Dockerfile，避免硬编码数据库地址，改用环境变量实现动态配置：

FROM openjdk:17-jdk-slim
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENV DB_URL=jdbc:postgresql://host.docker.internal:52801/account_db
ENTRYPOINT ["java","-jar","/app.jar"]

测试时可通过withEnv覆盖默认的DB_URL，适配不同环境。

验证方式 #

修改配置后重新运行测试，也可进入AccountService容器内部，用psql -h host.docker.internal -p 52801 -U your-user -d account_db命令手动测试数据库连接，确认是否正常。

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