NestJS生产环境下数据库持续无响应问题求助

一、排查连接池配置异常 #

• 检查TypeORM配置中的connectionLimit（MySQL）或max（PostgreSQL）参数，确保设置值不超过数据库允许的最大连接数（可通过show variables like 'max_connections';（MySQL）或SHOW max_connections;（PostgreSQL）查看）。若应用侧设置过大，会导致数据库连接耗尽，后续请求无法获取连接。
• 配置连接超时与回收机制：添加connectTimeout、acquireTimeout、idleTimeoutMillis等参数，避免闲置连接长期占用资源，同时确保超时后自动回收连接。示例配置：

// ormconfig.ts 或 app.module.ts 中的TypeORM配置
{
  type: 'mysql',
  host: process.env.DB_HOST,
  port: parseInt(process.env.DB_PORT),
  username: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME,
  entities: [__dirname + '/**/*.entity{.ts,.js}'],
  synchronize: false,
  pool: {
    max: 10, // 建议不超过数据库max_connections的70%
    min: 2,
    idleTimeoutMillis: 30000, // 闲置30秒回收连接
    acquireTimeoutMillis: 60000, // 获取连接超时时间
    connectTimeout: 10000 // 连接数据库超时时间
  }
}

二、排查连接泄漏问题 #

• 检查是否存在未正确释放的QueryRunner实例：使用手动获取的QueryRunner时，必须在操作完成后调用release()方法，哪怕发生异常也要确保释放（通过try/finally包裹）。示例：

const queryRunner = connection.createQueryRunner();
try {
  await queryRunner.connect();
  // 执行数据库操作
} catch (err) {
  // 异常处理
} finally {
  await queryRunner.release(); // 必须释放连接
}

• 检查事务是否正确提交/回滚：使用TypeORM事务时，若未在异常场景下执行rollback()，会导致连接被长时间占用无法释放。确保事务代码用try/catch包裹，异常时触发回滚：

// 自动事务模式
await connection.transaction(async manager => {
  try {
    // 事务操作
    await manager.save(Entity);
  } catch (err) {
    throw err; // 抛出异常自动触发回滚
  }
});

// 手动事务模式
const queryRunner = connection.createQueryRunner();
await queryRunner.startTransaction();
try {
  await queryRunner.manager.save(Entity);
  await queryRunner.commitTransaction();
} catch (err) {
  await queryRunner.rollbackTransaction();
} finally {
  await queryRunner.release();
}

三、数据库端配置优化 #

• 调整数据库连接超时参数：MySQL中设置wait_timeout和interactive_timeout（建议设为300秒左右），避免数据库主动断开连接后，应用侧仍持有无效连接；PostgreSQL调整idle_in_transaction_session_timeout，防止事务中闲置连接占用资源。
• 监控数据库连接状态：定期执行show processlist;（MySQL）或SELECT * FROM pg_stat_activity;（PostgreSQL），查看是否存在大量Sleep/Idle状态的连接，以及是否有长时间未结束的事务。

四、TypeORM版本与依赖排查 #

• 检查TypeORM版本是否存在已知连接池bug：部分旧版本（如0.2.x系列早期版本）存在连接池泄漏问题，建议升级到稳定版本（如0.3.x最新版），同时确保@nestjs/typeorm与TypeORM版本兼容。
• 排查数据库驱动版本：确保mysql2、pg等驱动版本与TypeORM、数据库版本兼容，避免因驱动bug导致连接异常。

五、应用侧监控与日志 #

• 开启TypeORM详细日志：在配置中设置logging: ['error', 'warn', 'info']（生产环境避免开启all级日志），记录连接获取、释放、超时等日志，便于定位问题发生时的连接状态。
• 新增连接池监控：通过TypeORM的connection.pool对象获取连接池状态（如已用连接数、空闲连接数），定期输出监控日志，实时追踪连接池变化。

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