Node.js 配合 MySQL 可構建高性能服務端應用。本文系統講解 mysql / mysql2 驅動的基本用法、連接池配置、多語句執行與生產級封裝模式。
npm install mysql
# 或推荐使用更高性能的 mysql2
npm install mysql2
const mysql = require('mysql');
const connection = mysql.createConnection({
host: 'localhost',
user: 'username',
password: 'password',
database: 'database_name',
timezone: 'UTC', // 可选:时区
// socketPath: '/tmp/mysql.sock', // 可选:Unix Socket
});
connection.connect((err) => {
if (err) throw err;
console.log('MySQL 連接成功');
});
connection.query('USE database1');
const strQuery = 'SELECT * FROM table1 WHERE id = ?';
connection.query(strQuery, [userId], (err, rows) => {
if (err) throw err;
console.log(rows);
});
connection.end(callback):優雅關閉,等待隊列查詢完成connection.destroy():立即強制斷開,無回調連接池可限制最大連接數、復用連接、避免頻繁建立/銷毀開銷。
const pool = mysql.createPool({
host: 'localhost',
user: 'username',
password: 'password',
database: 'database_name',
connectionLimit: 10, // 最大連接數
queueLimit: 0, // 等待隊列上限(0 不限)
acquireTimeout: 60000, // 獲取連接超時(ms)
timeout: 60000, // 空閒超時
});
pool.getConnection((err, connection) => {
if (err) throw err;
connection.query('SELECT * FROM table1', (err, rows) => {
connection.release(); // 必須釋放回池!
if (err) throw err;
console.log(rows);
});
});
lib/mysql.js
const mysql = require('mysql');
const pool = mysql.createPool({
host: 'localhost',
user: 'user',
password: 'password',
database: 'database',
port: 3306,
connectionLimit: 20,
});
const query = (sql, params, callback) => {
// 支持 query(sql, callback) 和 query(sql, params, callback) 兩種調用
if (typeof params === 'function') {
callback = params;
params = [];
}
pool.getConnection((err, conn) => {
if (err) return callback(err, null, null);
conn.query(sql, params, (qerr, vals, fields) => {
conn.release(); // 先釋放連接,再執行回調,提高併發
callback(qerr, vals, fields);
});
});
};
module.exports = query;
业务代码调用
const query = require('./lib/mysql.js');
query('SELECT * FROM users WHERE id = ?', [1], (err, rows, fields) => {
if (err) return console.error(err);
console.log(rows);
});
默認禁止多語句,需在創建連接/池時開啟:
const connection = mysql.createConnection({ multipleStatements: true });
connection.query('SELECT 1; SELECT 2; SELECT 3;', (err, results) => {
if (err) throw err;
console.log(results[0]); // [{ '1': 1 }]
console.log(results[1]); // [{ '2': 2 }]
console.log(results[2]); // [{ '3': 3 }]
});
安全提示:開啟多語句增加 SQL 注入風險,務必配合參數化查詢使用,避免拼接用戶輸入。
release()release(),防止連接泄漏pool._allConnections.length、pool._freeConnections.lengthmysql2 + Promise 封裝(支持 await pool.execute())