部署Node.js+Express后端后，如何用Sequelize连接Google Cloud SQL？

核心差异：本地与GAE的连接逻辑 #

本地通过Cloud SQL Auth Proxy用TCP端口（127.0.0.1:3306）连接，但GAE生产环境必须用Unix套接字（或私有IP，套接字配置更简便），这是导致500错误的核心原因。

1. 修正Sequelize环境区分配置 #

直接根据运行环境切换连接参数，避免硬编码：

const { Sequelize } = require('sequelize');

// 从环境变量读取配置（本地可通过.env文件，GAE直接配置环境变量）
const isProd = process.env.NODE_ENV === 'production';

const sequelize = new Sequelize(
  process.env.DB_NAME,
  process.env.DB_USER,
  process.env.DB_PASSWORD,
  {
    dialect: 'mysql',
    dialectOptions: isProd 
      ? { socketPath: `/cloudsql/${process.env.CLOUD_SQL_CONN_NAME}` }
      : { host: '127.0.0.1', port: 3306 },
    logging: isProd ? false : console.log, // 生产环境禁用日志减少开销
    pool: { max: 5, min: 0, acquire: 30000, idle: 10000 }
  }
);

注：CLOUD_SQL_CONN_NAME格式为项目ID:区域:实例ID，可在Cloud SQL控制台实例详情页获取。

2. 完善app.yaml配置 #

确保GAE拥有Cloud SQL访问权限，同时配置必要环境变量：

runtime: nodejs20 # 替换为你使用的Node.js版本
env: standard

env_variables:
  NODE_ENV: production
  DB_NAME: 你的数据库名称
  DB_USER: 数据库账号
  DB_PASSWORD: 数据库密码
  CLOUD_SQL_CONN_NAME: 你的Cloud SQL连接名

# 关键配置：赋予GAE访问Cloud SQL的权限
beta_settings:
  cloud_sql_instances: 你的Cloud SQL连接名

3. 必做检查项 #

• 数据库账号权限：确保使用的账号拥有实例访问权限（套接字连接无需IP白名单，GAE会自动完成身份认证）
• 环境变量有效性：部署后执行gcloud app versions describe <版本ID>，确认所有配置项已正确加载
• 日志排查：用gcloud app logs tail -s default实时查看GAE日志，500错误的具体原因（如账号密码错误、数据库不存在）会直接输出在这里

4. 新增连接测试逻辑 #

在server.js启动前添加连接校验，快速定位问题：

async function checkDBConnection() {
  try {
    await sequelize.authenticate();
    console.log('✅ 数据库连接成功');
  } catch (err) {
    console.error('❌ 数据库连接失败:', err);
    throw err; // 生产环境抛出错误触发GAE进程重启
  }
}

// 先验证数据库连接，再启动服务
checkDBConnection().then(() => {
  app.listen(process.env.PORT || 8080, () => {
    console.log('🚀 服务启动完成');
  });
});

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