Docker容器中Laravel连接PostgreSQL失败问题求助

我来帮你排查Laravel容器连接同主机独立PostgreSQL容器的问题，这几个点是最容易出状况的，你一步步检查：

1. 确保两个容器在同一Docker网络 #

Docker容器默认是网络隔离的，只有在同一个网络里才能互相访问。建议显式创建自定义网络，避免默认网络的兼容性问题：

如果你用docker-compose管理两个容器 #

在你的docker-compose.yml里补充网络配置：

version: '3'
services:
  app:
    # 你现有app服务的所有配置...
    networks:
      - laravel-postgres-network
  # 新增PostgreSQL服务配置（如果你的PostgreSQL是单独启动的，跳过这部分，看下面的命令）
  db:
    image: postgres:latest
    container_name: "postgres-db"
    env_file: .env
    environment:
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_PASSWORD=${DB_PASS}
      - POSTGRES_DB=${DB_DATABASE}
    ports:
      - "${DB_PORT}:5432"
    networks:
      - laravel-postgres-network

# 定义自定义网络
networks:
  laravel-postgres-network:
    driver: bridge

如果你的PostgreSQL是单独用docker run启动的 #

执行这条命令把它加入上面创建的自定义网络：

docker network connect laravel-postgres-network 你的PostgreSQL容器名称

2. 修正.env里的DB_HOST配置 #

这是最容易踩的坑：

• 绝对不能用localhost或127.0.0.1！Laravel容器里的localhost指的是容器自身，不是宿主机。
• 正确配置：
  • 如果PostgreSQL是docker-compose里的服务，DB_HOST=db（对应你postgres服务的名称）
  • 如果是单独容器，DB_HOST=你的PostgreSQL容器名称，或者用容器的IP（可以通过docker inspect 容器名 | grep IPAddress查看）

3. 验证PostgreSQL的端口与权限 #

• 确认PostgreSQL容器的5432端口已映射，且.env里的DB_PORT和映射端口一致（默认是5432）。
• 检查数据库用户权限：进入PostgreSQL容器验证用户能否正常访问目标数据库：

docker exec -it 你的PostgreSQL容器名 psql -U ${DB_USER} -d ${DB_DATABASE}

如果能成功进入数据库，说明用户、密码和数据库都是正常的。

4. 检查Laravel容器的环境变量加载 #

有时候.env的变量没正确传到容器里，进入Laravel容器验证：

docker exec -it laravel printenv | grep DB_

查看输出的DB_HOST、DB_PORT等参数是否和你本地.env文件一致，如果不一致，检查docker-compose.yml里的env_file路径是否正确，或者有没有在environment字段里设置了错误的覆盖值。

5. 测试容器间的连通性 #

进入Laravel容器，直接测试和PostgreSQL的连通性：

# 进入Laravel容器
docker exec -it laravel bash
# ping PostgreSQL容器名称，看是否能通
ping 你的PostgreSQL容器名
# 用telnet测试端口是否开放
telnet 你的PostgreSQL容器名 5432

如果ping不通，说明网络配置有问题；如果telnet连不上，可能是PostgreSQL没监听该端口，或者有防火墙限制。

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