NestJS通过Cloud SQL Proxy连接Google Cloud MySQL时连接被关闭如何解决

核心根因推测 #

• 首次连接超时：Cloud SQL Proxy首次创建连接时需要刷新临时证书，会产生额外的连接延迟，TypeORM默认的连接超时阈值过低，导致初始化连接创建失败，连接池无可用存活连接，后续请求拿连接时直接报错。
• 连接池与Proxy的空闲超时不匹配：Cloud SQL Proxy默认会关闭空闲超过10分钟的连接，若TypeORM连接池的空闲回收时间长于该阈值，会导致连接池持有已被Proxy关闭的无效连接，请求使用无效连接时抛出拒绝错误。
• 依赖版本隐性变更：若依赖声明使用了动态版本号（如^、~前缀），近期TypeORM、mysql2等相关依赖自动升级后，默认连接参数发生变动，导致原有兼容逻辑失效。

分步排查解决方法 #

• 第一步：显式配置TypeORM连接与连接池参数
  在原有TypeORM配置中新增以下参数，覆盖默认的不合理配置：

TypeOrmModule.forRoot({
  // 原有数据库连接配置（host、port、账号密码、库名等）保持不变
  connectTimeout: 10000, // 连接超时设置为10秒，覆盖默认短超时，适配Proxy证书刷新的延迟
  keepConnectionAlive: true, // 强制保持连接存活
  pool: {
    min: 2, // 保留最少2个空闲连接，避免连接被全量回收
    idleTimeout: 180000, // 空闲连接3分钟后回收，短于Proxy默认10分钟的空闲超时阈值，避免持有无效连接
    acquireTimeout: 10000, // 从连接池获取连接的超时设置为10秒
  },
  extra: {
    validateConnection: true, // 每次使用连接前先验证有效性
  },
  // 排查阶段可开启日志定位问题
  logging: ['error', 'warn']
})

• 第二步：验证Cloud SQL Proxy运行配置
  启动Proxy时显式指定空闲超时参数，确保和应用侧配置匹配：
  ./cloud_sql_proxy -instances=<实例连接名>=tcp:3306 --idle-timeout=600s
  同时检查Proxy运行日志，确认没有权限、实例连通性相关的报错。
• 第三步：排查依赖版本变动
  对比锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）中typeorm、mysql2包的版本，确认和之前正常运行时的版本是否一致，若有升级可先回退到历史版本验证是否恢复。
• 第四步：验证连接有效性
  应用启动后，先调用一个简单的数据库查询接口（如查询系统时间），确认是否能正常拿到返回，排除启动时初始化连接失败的问题。

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