Docker网络中Next.js构建时连接Postgres容器的问题求助

核心原因：构建阶段无法访问Docker Compose服务名 #

你遇到的问题本质是Next.js的getStaticProps在镜像构建阶段执行，而Docker镜像的构建过程完全独立于Compose服务网络——构建时test-app的构建容器还没加入Compose创建的网络，自然无法解析test-db这个服务名。哪怕配置了depends_on和健康检查也没用，因为这些只作用于容器启动阶段，和构建阶段无关。

解决方案 #

方案1：调整数据获取时机（推荐） #

把静态数据的获取从构建阶段移到运行阶段，彻底避开构建时的网络限制：

• 改用getServerSideProps：每次请求时实时从数据库拉取数据，此时test-app容器已在Compose网络内，能正常解析test-db服务名。
• 用增量静态再生（ISR）：在getStaticProps中添加revalidate参数，让Next.js在运行时定期重新生成静态页面，构建阶段可先返回占位内容，运行时再替换为真实数据。
• 提前导出静态数据：在本地先从数据库导出JSON文件，构建时直接读取本地文件，无需在构建阶段连接数据库。

方案2：让构建过程加入Compose网络（仅适用于必须构建时连数据库的场景） #

如果一定要在构建阶段访问test-db，需要手动让构建容器加入Compose的共享网络：

1. 先创建一个外部Docker网络：

   docker network create test-shared-network
   

2. 修改Docker Compose配置，指定服务使用该外部网络，并给test-app的构建过程绑定网络：

   version: '3'
   networks:
     test-shared-network:
       external: true
   services:
     test-app:
       container_name: test-app
       build:
         context: .
         network: test-shared-network  # 关键：构建时加入共享网络
       restart: always
       ports:
         - "3000:3000"
       environment:
         PGHOST: test-db
         PGPORT: 5432
         PGDATABASE: postgres
         PGUSER: postgres
         PGPASSWORD: postgres
       depends_on:
         test-db:
           condition: service_healthy
       networks:
         - test-shared-network
     test-db:
       container_name: test-db
       environment:
         POSTGRES_DB: postgres
         POSTGRES_USER: postgres
         POSTGRES_PASSWORD: postgres
       image: postgres:latest
       healthcheck:
         test: ["CMD", "pg_isready", "-U", "postgres", "-d", "postgres"]
         interval: 5s
         timeout: 10s
         retries: 5
       ports:
         - "5432:5432"
       volumes:
         - postgres-data:/var/lib/postgresql/data
       networks:
         - test-shared-network
   volumes:
     postgres-data:
   

3. 先启动test-db并等待它就绪：

   docker-compose up -d test-db
   

4. 再构建并启动test-app：

   docker-compose up --build test-app
   

这样构建阶段的容器会加入共享网络，能直接解析test-db服务名。

方案3：临时绕过网络限制（快速测试用） #

利用主机端口映射，让构建容器通过主机访问test-db：

• Windows/Mac环境：构建时设置PGHOST=host.docker.internal（Docker内置的主机别名）：

  docker build --build-arg PGHOST=host.docker.internal .
  

• Linux环境：设置PGHOST为主机的局域网IP（比如192.168.1.100），因为Linux的Docker容器默认无法用localhost直接访问主机。
• 注意：必须确保test-db容器已启动，且5432端口已映射到主机。

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