萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Node.js 連接 MySQL 實戰:從基礎查詢到連接池最佳實踐

Node.js 配合 MySQL 可構建高性能服務端應用。本文系統講解 mysql / mysql2 驅動的基本用法、連接池配置、多語句執行與生產級封裝模式。

一、基礎連接與查詢

1. 安裝驅動

npm install mysql
# 或推荐使用更高性能的 mysql2
npm install mysql2

2. 創建單連接

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 連接成功');
});

3. 執行查詢(防注入)

connection.query('USE database1');
const strQuery = 'SELECT * FROM table1 WHERE id = ?';
connection.query(strQuery, [userId], (err, rows) => {
  if (err) throw err;
  console.log(rows);
});

4. 關閉連接

  • connection.end(callback):優雅關閉,等待隊列查詢完成
  • connection.destroy():立即強制斷開,無回調

二、連接池最佳實踐

連接池可限制最大連接數、復用連接、避免頻繁建立/銷毀開銷。

1. 創建連接池

const pool = mysql.createPool({
  host: 'localhost',
  user: 'username',
  password: 'password',
  database: 'database_name',
  connectionLimit: 10,    // 最大連接數
  queueLimit: 0,          // 等待隊列上限(0 不限)
  acquireTimeout: 60000,  // 獲取連接超時(ms)
  timeout: 60000,         // 空閒超時
});

2. 從池獲取連接並查詢

pool.getConnection((err, connection) => {
  if (err) throw err;
  
  connection.query('SELECT * FROM table1', (err, rows) => {
    connection.release(); // 必須釋放回池!
    if (err) throw err;
    console.log(rows);
  });
});

3. 封裝通用查詢模塊(推薦生產模式)

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.length
  • ✅ 生產環境建議使用 mysql2 + Promise 封裝(支持 await pool.execute())
copyright © 萬盛學電腦網 all rights reserved