如何在GAE生产环境配置Cloud SQL Proxy使用TCP套接字而非UNIX套接字

我之前在部署Node.js应用到GAE时，也遇到过第三方库不兼容UNIX套接字的情况，折腾了好久才搞定！下面是具体的配置步骤：

• 修改app.yaml配置
  在你的app.yaml文件中，需要添加beta_settings字段，指定Cloud SQL实例的TCP端口映射：

  runtime: nodejs20  # 替换成你使用的Node.js版本
  env: standard
  
  beta_settings:
    # 格式：[PROJECT_ID]:[REGION]:[INSTANCE_NAME]=tcp:[PORT]
    # 端口根据数据库类型选择：MySQL用3306，PostgreSQL用5432
    cloud_sql_instances: "your-project-id:us-central1:your-sql-instance=tcp:5432"
  
  env_variables:
    # 可选：如果你需要在代码中引用端口，可以设置环境变量
    DB_PORT: 5432
  

• 调整Node应用的数据库连接配置
  把原来使用UNIX套接字的连接字符串，改成TCP连接的格式：
  比如原来的UNIX套接字连接（PostgreSQL为例）：

  const client = new Client({
    host: '/cloudsql/your-project-id:us-central1:your-sql-instance',
    user: 'your-db-user',
    password: 'your-db-password',
    database: 'your-db-name'
  });
  

  改成TCP连接：

  const client = new Client({
    host: 'localhost',
    port: process.env.DB_PORT || 5432,
    user: 'your-db-user',
    password: 'your-db-password',
    database: 'your-db-name'
  });
  

• 验证Cloud SQL权限
  确保你的GAE服务账号（格式：PROJECT_ID@appspot.gserviceaccount.com）拥有Cloud SQL Client角色：

  • 进入Cloud Console的IAM页面
  • 找到对应的服务账号，添加Cloud SQL Client角色
  • 保存更改后，等待权限生效（通常需要几分钟）

• 关键注意事项

  • 这个配置仅适用于GAE标准环境，灵活环境的配置方式略有不同
  • 端口号要和数据库默认端口匹配，不要随便改未开放的端口
  • 部署前可以先用gcloud app deploy --verbosity=debug查看日志，确认Cloud Proxy是否成功监听TCP端口

这样配置后，GAE内置的Cloud Proxy就会在生产环境中监听指定的TCP端口，你的Node应用就能通过TCP连接数据库，避开UNIX套接字的兼容性问题了！

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