App Engine(PHP)连接Cloud SQL失败问题求助

我之前在做App Engine PHP项目连接Cloud SQL的时候，也踩过不少坑，结合你的配置和场景，给你梳理几个关键的排查方向，应该能帮你解决连接失败的问题：

1. 检查Cloud SQL实例的授权与区域匹配 #

• 首先确认你的App Engine服务账号（格式为你的项目ID@appspot.gserviceaccount.com）已经被添加到Cloud SQL实例的IAM权限列表中，至少要授予Cloud SQL Client角色，这样App Engine才有访问实例的权限。
• 另外要注意：你的Cloud SQL实例在europe-west3区域，必须确保你的App Engine应用也部署在同一个区域——标准环境下App Engine的区域是创建应用时指定的，如果区域不匹配，unix socket连接会直接失败。

2. 验证app.yaml的环境变量配置 #

• 核对MYSQL_DSN里的实例连接名：格式是项目ID:区域:实例名，你写的sampleproject:europe-west3:sampleinstance要确保项目ID、区域、实例名完全和Cloud SQL控制台里的一致，哪怕一个字母拼写错误都会导致连接失败。
• 确认PHP5.5环境的pdo_mysql扩展已启用：虽然App Engine PHP5.5默认包含这个扩展，但可以在项目根目录创建php.ini文件，添加extension=pdo_mysql.so来强制启用，避免扩展未加载的问题。

3. 补全并优化数据库连接代码 #

你提到的代码片段没写完，完整的PDO连接代码应该包含异常捕获，这样能直接看到具体错误原因，比如：

<?php
try {
    $dsn = getenv('MYSQL_DSN');
    $user = getenv('MYSQL_USER');
    $password = getenv('MYSQL_PASSWORD');
    
    // 初始化PDO连接
    $db = new PDO($dsn, $user, $password);
    // 开启异常模式，方便排查错误
    $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    
    echo "数据库连接成功！";
} catch(PDOException $e) {
    die("连接失败详情: " . $e->getMessage());
}

加上异常捕获后，你就能看到是权限不足、实例不存在还是数据库未创建这类具体问题，比盲目排查高效得多。

4. 确认数据库与用户权限 #

• 检查sampledb数据库是否已经在Cloud SQL实例中创建，没有拼写错误。
• 确认root用户的密码admin是正确的，并且该用户拥有访问sampledb的权限——可以在Cloud SQL控制台的Users页面查看，或者通过SQL命令GRANT ALL PRIVILEGES ON sampledb.* TO 'root'@'%';来赋予权限（执行后记得FLUSH PRIVILEGES;）。

5. 本地测试连接（快速排查） #

如果安装了Cloud SDK，可以在本地执行命令：

gcloud sql connect sampleinstance --user=root

输入密码admin后，尝试执行USE sampledb;来访问数据库，如果本地能正常连接，说明数据库本身没问题，问题出在App Engine的配置或授权上。

如果按照以上步骤排查后还是无法解决，把异常捕获到的具体错误信息贴出来，这样能更精准地定位问题。

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