Google Cloud两项目中App Engine(新)无法连接Cloud SQL，报错SQLSTATE[HY000] [2002]

这个错误我之前帮不少开发者排查过，核心问题通常不是你已经配置的IAM Project Editor权限，而是Cloud SQL的连接配置细节和精准权限设置没到位，咱们一步步来解决：

1. 给新App Engine服务账号添加Cloud SQL专属权限 #

别以为Project Editor权限就覆盖一切了——虽然它权限范围广，但有时候会因为细粒度权限控制的问题，导致连接Cloud SQL的核心权限没生效。你需要在拥有Cloud SQL的第一个项目里，给新App Engine的默认服务账号明确授予Cloud SQL Client角色：

• 打开第一个项目的IAM页面，点击「添加」
• 输入新App Engine项目的默认服务账号（格式是：新项目ID@appspot.gserviceaccount.com）
• 搜索并选择Cloud SQL Client角色，保存后等待5-10分钟让权限生效

2. 检查App Engine（新）的app.yaml配置 #

报错No such file or directory大概率是因为Unix socket路径没配置对，这是跨项目连接最容易踩的坑：

• 在app.yaml里必须添加cloud_sql_instances配置项，注意这里要填拥有Cloud SQL的第一个项目的信息：

  env_variables:
    # 你的其他环境变量...
  cloud_sql_instances: "旧项目ID:实例所在区域:实例名称"
  

  别把项目ID写成新项目的！区域和实例名也要和第一个项目里的Cloud SQL完全一致。

3. 修正代码中的连接字符串 #

以PHP PDO为例，你的连接字符串必须指向Cloud SQL的Unix socket路径，而不是localhost或公网IP：

$dsn = 'mysql:unix_socket=/cloudsql/旧项目ID:实例所在区域:实例名称;dbname=你的数据库名';
$pdo = new PDO($dsn, '数据库用户名', '数据库密码');

如果是Python、Node.js等其他语言，也要确保连接时指定的是/cloudsql/旧项目ID:区域:实例名这个socket路径，而不是常规的host地址。

4. 额外排查点 #

• 如果你的Cloud SQL是私有网络模式，需要确保两个项目的VPC已经通过VPC peering连接，并且新App Engine配置了VPC访问连接器
• 权限生效后，重新部署你的App Engine服务，避免旧配置缓存干扰
• 确认Cloud SQL实例处于「运行中」状态，没有暂停或维护

按照这几步操作下来，基本就能解决这个2002连接错误了。

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