使用Sequelize连接Google Cloud SQL实例时出现连接错误求助

问题详情 #

此前连接正常的Node.js应用，使用Sequelize连接Google Cloud SQL Postgres实例时突然报错，连接函数代码如下：

async function loadSequelize() {
  //This connection is for Google Cloud ONLY (IF You want to connect locally please change the connection config).
  const sequelize = new Sequelize(process.env.DEFAULT_DATABASE_NAME, process.env.DATABASE_USER, process.env.DATABASE_PASSWORD, {
    dialect: 'postgres',
    logging: false,
    // e.g. host: '/cloudsql/my-awesome-project:us-central1:my-cloud-sql-instance'
    host: process.env.INSTANCE_UNIX_SOCKET,
    pool: {
        max: 2,
        min: 0,
        acquire: 10000,
        idle: 0
    },
    dialectOptions: {
        // e.g. socketPath: '/cloudsql/my-awesome-project:us-central1:my-cloud-sql-instance'
        // same as host string above
        socketPath: process.env.INSTANCE_UNIX_SOCKET
    },
    logging: false,
    operatorsAliases: false
  });
  await sequelize.authenticate();
  return sequelize;
}

运行时抛出错误：

ConnectionError [SequelizeConnectionError]: connect ENOENT /cloudsql/my-awesome-project:us-central1:my-cloud-sql-instance.s.PGSQL.5432

本地运行应用时问题依然存在，未修改过连接配置。

原因分析 #

ENOENT错误表示系统找不到指定的Unix套接字文件，核心原因是Unix套接字路径不可用，可能涉及代理运行状态、配置错误、权限问题或Cloud SQL实例异常。

排查建议 #

1. 确认Cloud SQL Auth代理是否正常运行 #

无论本地还是GCP环境（如App Engine、Cloud Run），使用Unix套接字连接Postgres都依赖Cloud SQL Auth代理：

• 本地环境：执行ps aux | grep cloud_sql_proxy检查代理进程是否存活，若未运行则重新启动代理（启动命令示例：./cloud_sql_proxy -instances=PROJECT_ID:REGION:INSTANCE_NAME=tcp:5432）。
• GCP托管环境：检查服务账号是否拥有Cloud SQL Client权限，且实例连接配置已正确挂载。

2. 验证INSTANCE_UNIX_SOCKET环境变量的正确性 #

确认环境变量值格式为/cloudsql/[PROJECT_ID]:[REGION]:[INSTANCE_NAME]，不要手动添加.s.PGSQL.5432后缀——Sequelize会自动为socketPath拼接该后缀，手动添加会导致路径错误。

3. 检查套接字文件权限（本地环境） #

代理生成的套接字文件默认在/cloudsql目录下，执行ls -l /cloudsql/[INSTANCE_CONNECTION_NAME]查看权限，确保运行Node.js应用的用户拥有读/写权限，必要时调整用户组或权限。

4. 检查Cloud SQL实例状态 #

登录Google Cloud Console确认：

• 实例处于运行中状态，无重启、维护或配额超限记录。
• Postgres服务端口（5432）未被限制，数据库用户权限未被修改。

5. 清理Sequelize冗余配置 #

你的代码中同时设置了host和dialectOptions.socketPath，对于Postgres Unix套接字连接，仅需保留dialectOptions.socketPath即可，冗余配置可能导致连接逻辑冲突。修改后示例：

const sequelize = new Sequelize(process.env.DEFAULT_DATABASE_NAME, process.env.DATABASE_USER, process.env.DATABASE_PASSWORD, {
  dialect: 'postgres',
  logging: false,
  pool: {
      max: 2,
      min: 0,
      acquire: 10000,
      idle: 0
  },
  dialectOptions: {
      socketPath: process.env.INSTANCE_UNIX_SOCKET
  },
  operatorsAliases: false
});

6. 测试基础连接可用性 #

跳过Sequelize，直接用psql测试底层连接：

psql "host=/cloudsql/[INSTANCE_CONNECTION_NAME] user=[DATABASE_USER] dbname=[DEFAULT_DATABASE_NAME]"

若该命令也失败，说明问题出在底层连接而非Sequelize配置。

内容的提问来源于stack exchange，提问作者Roni Jack Vituli