GAE Flex应用无需外部连接（免全局白名单）连接第一代CloudSQL可行吗？

当然可以不用设置全局IP白名单就能连接！GAE Flex原生支持通过内部套接字通道和第一代CloudSQL实例通信，我来帮你梳理正确的配置步骤和容易踩的坑：

关键前提：获取实例连接名称 #

首先要拿到你的第一代CloudSQL实例的实例连接名称，格式为项目ID:区域:实例名，你可以在CloudSQL控制台的「实例详情」页面找到这个值，后面所有配置都要用到它。

步骤1：配置app.yaml文件 #

在你的GAE Flex应用的app.yaml中，必须添加CloudSQL的实例关联配置，示例如下：

runtime: python
env: flex

# 核心：关联CloudSQL实例
beta_settings:
    cloud_sql_instances: "你的实例连接名称"

# 可选：如果使用自定义服务账号，确保它有CloudSQL访问权限
# service_account: your-custom-service-account@your-project.iam.gserviceaccount.com

注意：如果有多个CloudSQL实例，用逗号分隔即可，比如"实例1连接名称,实例2连接名称"

步骤2：正确编写SQLAlchemy连接字符串 #

这是很多人出错的地方，正确的连接字符串需要通过unix_socket指定内部套接字路径，而不是使用IP地址。示例代码如下：

from sqlalchemy import create_engine

# 替换成你的实际信息：用户名、密码、数据库名、实例连接名称
DB_USER = "你的CloudSQL数据库用户名"
DB_PASS = "你的CloudSQL数据库密码"
DB_NAME = "要连接的数据库名称"
INSTANCE_CONNECTION_NAME = "你的实例连接名称"

# 重点：unix_socket路径必须是/cloudsql/加上实例连接名称
db_url = f"mysql+pymysql://{DB_USER}:{DB_PASS}@/{DB_NAME}?unix_socket=/cloudsql/{INSTANCE_CONNECTION_NAME}"
engine = create_engine(db_url)

需要注意的细节：

• 不要指定host参数（比如localhost或127.0.0.1），完全通过unix_socket来指定连接通道
• 用户名和密码是你在CloudSQL中创建的数据库账号（不是Google Cloud的账号）
• 确保pymysql已经添加到你的requirements.txt中

步骤3：检查服务账号权限 #

GAE Flex默认使用你的项目ID@appspot.gserviceaccount.com这个服务账号，需要确保它拥有Cloud SQL Client角色：

• 打开Google Cloud IAM控制台
• 找到这个默认服务账号
• 点击「编辑」，添加「Cloud SQL Client」角色并保存

常见坑点避坑 #

• 第一代CloudSQL不需要开启私有IP：GAE Flex的内部连接是通过内置的CloudSQL代理实现的，不用额外配置VPC私有IP，别做无用功
• 套接字路径必须完全正确：/cloudsql/后面直接跟实例连接名称，不要加任何多余的字符或路径
• 本地测试注意：如果你在本地开发环境测试，需要启动CloudSQL代理，不能直接用这个连接字符串，线上部署后会自动生效

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