部署在Google App Engine的Symfony应用无法连接Cloud SQL问题咨询

根本原因定位 #

你遇到的连接异常核心是两个问题叠加：

1. Symfony 5.2版本的PdoSessionHandler组件对PDO连接参数的解析逻辑存在缺陷，无法自动识别带unix_socket的DATABASE_URL配置
2. 手动配置PDO参数时未传入Google Cloud SQL要求的unix_socket路径，导致PDO默认走TCP连接，无法适配App Engine到Cloud SQL的内网连接逻辑
   升级到Symfony 5.3后问题自动解决，是因为该版本修复了PdoSessionHandler的参数解析bug，可自动识别unix_socket配置。

前置权限检查 #

先确认基础配置没有问题：

• App Engine默认服务账号（格式为{项目ID}@appspot.gserviceaccount.com）已被授予Cloud SQL Client角色，该权限是App Engine通过unix_socket连接Cloud SQL的必要条件
• Cloud SQL实例的INSTANCE_CONNECTION_NAME填写正确，格式为{项目ID}:{区域}:{实例名}，可直接在Cloud SQL实例概览页复制
• 若使用公网IP连接，需将App Engine的出口IP段添加到Cloud SQL的公网访问白名单，官方更推荐使用unix_socket内网连接，无需配置白名单

具体解决方法 #

方案1：不升级Symfony 5.2直接修复 #

修改config/services.yaml中的PdoSessionHandler配置，显式传入unix_socket参数：

# config/services.yaml
Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
    arguments:
        - "mysql:dbname=%env(DB_NAME)%;unix_socket=%env(CLOUD_SQL_SOCKET)%"
        - { db_username: "%env(DB_USER)%", db_password: "%env(DB_PASS)%" }

同步更新app.yaml中的环境变量：

runtime: php74
env_variables:
  APP_ENV: prod
  APP_SECRET: 你的APP_SECRET
  DB_NAME: symfonydb
  DB_USER: root
  DB_PASS: 你的数据库密码
  CLOUD_SQL_SOCKET: "/cloudsql/你的INSTANCE_CONNECTION_NAME"
  # 对应Doctrine的DATABASE_URL也可以用同样的格式
  DATABASE_URL: "mysql://%env(DB_USER)%:%env(DB_PASS)%@/%env(DB_NAME)%?unix_socket=%env(CLOUD_SQL_SOCKET)%"

注意：PDO的DSN中如果同时配置了host和unix_socket，会优先走TCP连接，所以unix_socket连接模式下不要添加host、port参数。

方案2：升级到Symfony 5.3+（官方推荐） #

Symfony 5.3及以上版本已修复PdoSessionHandler的参数解析缺陷，只要保证DATABASE_URL配置正确，无需额外调整PdoSessionHandler的参数即可正常连接：

# app.yaml中DATABASE_URL写法
DATABASE_URL: mysql://root:你的数据库密码@/symfonydb?unix_socket=/cloudsql/你的INSTANCE_CONNECTION_NAME

常见报错对应排查 #

• SQLSTATE[HY000] [2002] No such file or directory：PDO找不到unix_socket文件，排查方向：INSTANCE_CONNECTION_NAME填写错误、服务账号未授予Cloud SQL Client权限、DSN中未配置unix_socket参数
• SQLSTATE[HY000] [2002] Connection refused：DSN中配置了host为127.0.0.1/localhost但未配置unix_socket，本地没有运行MySQL实例，去掉host参数添加unix_socket即可
• SQLSTATE[HY000] [2002] Connection timed out：使用公网IP连接但未将App Engine出口IP添加到Cloud SQL公网白名单，要么补充白名单要么切换到unix_socket连接模式

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