本文详解 node.js 中使用 `mysql` 包时的连接生命周期管理：说明单连接长期复用的合理性、为何不应在每次请求后手动 `end()`，以及如何通过连接池实现高性能、安全的数据库访问。
在你当前的代码中，使用 mysql.createConnection() 创建一个全局连接并在多个路由中复用，本身并非错误实践——只要该连接保持活跃且未被意外中断，它完全可以支撑整个应用生命周期内的请求。但关键在于：你不应在每个 HTTP 请求处理完后调用 connection.end()。原因如下：
- connection.end() 是终结整个连接对象的操作，执行后该连接不可再用；
- 若在 /getAll 路由中调用 .end()，后续请求再调用 connection.query() 就会抛出 Cannot enqueue Query after invoking quit. 等错误；
- 单连接长期持有虽可行，但存在单点故障风险（如网络闪断、MySQL 服务重启），且无法横向扩展。
✅ 推荐方案：改用连接池（Connection Pool）
连接池自动维护一组可复用的连接，在需要时分配、使用后归还，既避免频繁建立/销毁开销，又具备容错与并发能力。以下是标准实践：
const mysql = require('mysql');
// 创建连接池（推荐配置）
const pool = mysql.createPool({
connectionLimit: 10, // 最大并发连接数
host: 'localhost',
user: 'your_user',
password: 'your_password',
database: 'your_db',
waitForConnections: true, // 队列等待（默认 true）
queueLimit: 0, // 无限制排队（0 表示不限）
timeout: 60000, // 获取连接超时时间（ms）
});
// 在路由中安全使用
router.get('/getAll', (req, res) => {
pool.query('SELECT * FROM admin', (error, results) => {
if (error) {
console.error('Database query failed:', error);
return res.status(500).json({ status: 500, error: 'Database error' });
}
res.status(200).json({ status: 200, data: results });
});
});? 重要注意事项：
✅ 连接池无需、也不应手动关闭每个连接 —— pool.query() 内部自动完成获取 → 执行 → 归还流程；
-
✅ 应在应用优雅退出时关闭整个池，防止进程残留：
// 应用关闭前清理 const gracefulShutdown = () => { pool.end((err) => { if (err) { console.error('Error closing MySQL pool:', err); process.exit(1); } console.log('MySQL connection pool closed.'); process.exit(0); }); }; process.on('SIGTERM', gracefulShutdown); process.on('SIGINT', gracefulShutdown); ⚠️ 避免混合使用单连接 + 连接池；也不要在请求中 createConnection() 后不 end()（会导致连接泄漏）；
? 生产环境建议配合 mysql2 包（支持 Promise、更好的错误处理和性能）及连接健康检查（如定期 PING）。
总结：单连接适合极简原型，但真实项目务必迁移到连接池。它不仅是最佳实践，更是保障稳定性、可伸缩性与资源可控性的基石。
