NestJS+TypeORM(MySQL)中Sleep进程过多致查询阻塞问题求助

核心原因分析 #

sleep状态的MySQL进程本质是空闲数据库连接，TypeORM通过keepConnectionAlive: true开启了连接复用，但如果连接池配置不合理、MySQL超时参数未优化，会导致大量空闲连接长期处于sleep状态，占满MySQL的max_connections阈值，最终引发新请求无法获取连接、表锁阻塞等问题。

具体解决方案 #

1. 优化TypeORM连接池配置 #

在你的ormconfig中补充连接池相关参数，控制连接数量、空闲超时时间，避免无限制创建空闲连接：

synchronize: process.env.NODE_ENV !== 'production',
migrationsRun: process.env.NODE_ENV !== 'production',
autoLoadEntities: true,
logging: true,
bigNumberStrings: false,
entities: [
  __dirname + '/common/entity/**/*.{ts,js}',
  __dirname + '/common/view/**/*.{ts,js}',
],
keepConnectionAlive: true,
// 新增连接池配置
poolSize: process.env.NODE_ENV === 'production' ? 30 : 10, // 根据环境设置合理的连接池大小，不超过MySQL max_connections的80%
idleTimeoutMillis: 60000, // 空闲连接1分钟后自动销毁，放回MySQL连接池
connectionTimeoutMillis: 30000, // 获取连接的超时时间，避免请求无限等待

2. 调整MySQL服务器超时参数 #

修改MySQL配置文件（my.cnf/my.ini），设置自动清理空闲连接的超时时间：

# 非交互式连接超时时间（TypeORM连接默认属于此类）
wait_timeout = 600
# 交互式连接超时时间（部分驱动可能使用）
interactive_timeout = 600
# 根据服务器性能调整最大连接数，避免过小导致阻塞，过大占用资源
max_connections = 200

修改后重启MySQL服务生效。

3. 检查代码中连接/事务的正确释放 #

排查是否存在未正确释放的连接或事务：

• 手动执行查询时，确保没有遗漏连接释放（TypeORM大部分场景会自动管理，但手动调用getConnection().query()或自定义事务时需注意）
• 事务代码必须保证commit()或rollback()执行，避免异常导致连接长期占用后进入sleep状态

4. 按需关闭keepConnectionAlive（不推荐） #

如果测试环境不需要连接复用，可以临时关闭keepConnectionAlive: false，让TypeORM每次请求后关闭连接。但生产环境不建议关闭，连接复用能显著提升性能。

关键说明 #

sleep进程本身不是问题，合理数量的空闲连接是连接池复用的正常表现。只有当空闲连接数量超过MySQLmax_connections时，才会引发阻塞问题。通过上述配置，既能保留连接复用的性能优势，又能控制空闲连接的数量，避免出现大量sleep进程导致的异常。

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