如何配置Google Cloud SQL Server Beta与App Engine Node.js API的连接

刚好我前阵子帮团队部署过Node.js API连接Cloud SQL Server Beta的场景，踩了几个小坑，结合官方Beta文档和实际跑通的配置，给你详细说下：

一、直接连接的连接字符串配置（App Engine环境） #

本地用公网IP能连，但部署到App Engine后，建议用Cloud SQL的私有IP建立内网连接（更安全稳定），连接字符串配置取决于你用的数据库驱动（比如mssql或tedious），以下是最常用的mssql库的示例：

const sql = require('mssql');

// 直接连接配置（使用私有IP）
const dbConfig = {
  user: '你的数据库用户名',
  password: '你的数据库密码',
  database: '目标数据库名称',
  server: '你的Cloud SQL实例私有IP', // 注意：必须是实例的私有IP，而非公网IP
  options: {
    encrypt: true, // SQL Server强制要求加密连接
    trustServerCertificate: false, // 生产环境建议保持false，用CA证书验证
    connectTimeout: 30000, // 适当延长超时，避免App Engine冷启动时连接超时
  },
};

// 初始化连接池
const poolPromise = new sql.ConnectionPool(dbConfig)
  .connect()
  .then(pool => {
    console.log('成功连接到Cloud SQL Server');
    return pool;
  })
  .catch(err => {
    console.error('数据库连接失败:', err);
    throw err;
  });

二、使用实例连接名的配置方式 #

实例连接名格式为 [项目ID]:[区域]:[实例名称]，可在Cloud SQL控制台的实例详情页找到。在App Engine上，推荐用Unix Socket结合实例连接名连接，无需额外部署Auth Proxy，App Engine标准环境已内置支持，配置示例如下：

const sql = require('mssql');

// 使用实例连接名的配置
const dbConfig = {
  user: '你的数据库用户名',
  password: '你的数据库密码',
  database: '目标数据库名称',
  options: {
    encrypt: true,
    trustServerCertificate: false,
    // 核心配置：socket路径格式为 /cloudsql/实例连接名
    socketPath: '/cloudsql/your-project-id:us-central1:your-sqlserver-instance',
  },
};

const poolPromise = new sql.ConnectionPool(dbConfig)
  .connect()
  .then(pool => {
    console.log('通过实例连接名成功连接到Cloud SQL Server');
    return pool;
  })
  .catch(err => {
    console.error('连接失败:', err);
    throw err;
  });

关键注意事项 #

• 权限配置：确保App Engine默认服务账号（格式为 [项目ID]@appspot.gserviceaccount.com）拥有 roles/cloudsql.client 角色，可在IAM控制台给该账号添加权限。
• 驱动版本：建议使用 mssql@^9.0.0 或 tedious@^15.0.0 以上版本，这些版本对Cloud SQL Server Beta的Unix Socket连接支持更完善。
• 数据库用户权限：无需手动配置IP白名单，Socket连接走Google内部通道，只要数据库用户本身权限正常即可。
• 敏感信息管理：生产环境建议把用户名、密码、实例连接名存到Google Secret Manager或App Engine环境变量中，不要硬编码在代码里，比如通过 process.env.DB_USER 读取。

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