Laravel（GCP App Engine）连接GCP SQL PostgreSQL失败求助

你的错误根源是Laravel的PostgreSQL驱动未正确识别Cloud SQL的连接配置，以下是两种可靠的解决方案：

方案一：使用Unix套接字连接（推荐，安全高效） #

这是Google Cloud官方推荐的连接方式，无需暴露公网IP：

1. 修正app.yaml配置

   • 调整beta_settings中的实例配置，移除TCP端口后缀：

     beta_settings:
       cloud_sql_instances: app-id:zone:instance
     

   • 更新env_variables，删除DB_HOST和DB_PORT，添加套接字路径变量：

     env_variables:
       # 其他原有变量保持不变
       DB_CONNECTION: pgsql
       DB_DATABASE: postgres
       DB_USERNAME: instance
       DB_PASSWORD: password
       DB_UNIX_SOCKET: /cloudsql/app-id:zone:instance
     

2. 更新Laravel数据库配置
   打开config/database.php，找到connections下的pgsql数组，新增unix_socket参数：

   'pgsql' => [
       'driver' => 'pgsql',
       'url' => env('DATABASE_URL'),
       'host' => env('DB_HOST', '127.0.0.1'),
       'port' => env('DB_PORT', '5432'),
       'database' => env('DB_DATABASE', 'forge'),
       'username' => env('DB_USERNAME', 'forge'),
       'password' => env('DB_PASSWORD', ''),
       'charset' => 'utf8',
       'prefix' => '',
       'prefix_indexes' => true,
       'search_path' => 'public',
       'sslmode' => 'prefer',
       // 添加该行以支持套接字连接
       'unix_socket' => env('DB_UNIX_SOCKET'),
   ],
   

方案二：使用TCP连接 #

若需采用TCP方式，确保以下配置正确：

1. 确认app.yaml的beta_settings
   保留TCP端口配置，务必保证实例ID拼写完全正确：

   beta_settings:
     cloud_sql_instances: app-id:zone:instance=tcp:5432
   

2. 调整数据库环境变量
   将DB_HOST设为127.0.0.1（避免localhost解析问题），端口保持5432：

   env_variables:
     # 其他原有变量保持不变
     DB_CONNECTION: pgsql
     DB_HOST: 127.0.0.1
     DB_PORT: 5432
     DB_DATABASE: postgres
     DB_USERNAME: instance
     DB_PASSWORD: password
   

3. 验证数据库用户权限
   确保instance用户允许从任意主机连接，创建/授权语句示例：

   CREATE USER instance WITH PASSWORD 'password';
   GRANT ALL PRIVILEGES ON DATABASE postgres TO instance;
   

   不要限制用户仅能从localhost连接。

通用检查项 #

• 确认App Engine服务账号已拥有Cloud SQL Client角色（在IAM控制台为服务账号添加该角色）。
• 检查Cloud SQL实例状态为"RUNNING"，无异常。
• 核对数据库名称、用户名、密码完全正确，无拼写错误。

部署修改后的配置到App Engine，即可解决连接拒绝问题。

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