Node.js 連接 MySQL 數據庫指南

作者：史展碩
發布日期：2025年8月14日
閱讀時長：2分鐘
原文：https://ohen.hashnode.dev/connect-mysql-database-with-nodejs

Node.js 作為一項杰出的技術發明，有效實現了Web項目的前后端分離。盡管 NoSQL 數據庫日漸流行，MySQL 仍然是許多場景下的優質選擇。

安裝MySQL驅動

在Node.js中使用MySQL，首先需要安裝mysql npm包：

$ npm i mysql

導入模塊

根據項目模塊規范選擇導入方式：

// ES6+ 模塊
import { mysql } from 'mysql';

// CommonJS 規范
const mysql = require('mysql');

創建數據庫連接

建立與MySQL/MariaDB服務器的連接配置：

const connection = mysql.createConnection({
    host: 'localhost',
    user: 'root',
    password: 'yourpassword', 
    database: 'yourdb',
    port: 3306
});

建議：不要直接硬編碼敏感信息，后續文章將介紹如何使用.env文件管理配置

測試連接

connection.connect((err) => {
    if (err) {
        console.error('連接失敗:', err);
        return;
    }
    console.log('數據庫連接成功');
});

執行SQL查詢

基礎查詢示例：

connection.query(sql, values, (error, results) => {
    if (error) {
        // 錯誤處理...
    }
    // 結果處理...
});

實用Promise封裝

推薦將回調式查詢封裝為Promise：

function query(sql, values) {
    return new Promise((resolve, reject) => {
        connection.query(sql, values, (error, results) => {
            if (error) return reject(error);
            resolve(results);
        });
    });
}

// CommonJS導出
module.exports = query;

// ES6模塊導出
export default query;

使用示例

query('SELECT * FROM users WHERE username = ?', [username])
    .then(results => {
        if (results.length > 0) {
            res.json({ success: false });
        } else {
            res.json({ success: true });
        }
    })
    .catch(error => {
        console.error('查詢錯誤:', error);
        res.status(500).json({ 
            success: false, 
            error: '數據庫查詢異常' 
        });
    });