Node.js 連接 XAMPP MySQL 關鍵配置：socketPath 參數詳解

Node.js 連接 XAMPP MySQL 關鍵配置：socketPath 參數詳解

在 macOS/XAMPP 環境下，Node.js 使用 mysql 套件連線本機資料庫時，若不指定 Unix Socket 路徑，會報錯 Error: connect ECONNREFUSED。

正確連線代碼

var mysql = require('mysql');
var connection = mysql.createConnection({
  host: 'localhost',
  user: 'your_user',        // 替換為你的用戶名
  password: 'your_pass',    // 替換為你的密碼
  database: 'your_db',      // 替換為資料庫名
  socketPath: '/Applications/XAMPP/xamppfiles/var/mysql/mysql.sock', // 關鍵！
  port: 3306
});

connection.connect(function(err) {
  if (err) {
    console.error('error connecting: ' + err.stack);
    return;
  }
  console.log('connected as id ' + connection.threadId);
});

為什麼需要 socketPath？

• XAMPP MySQL 預設啟用 Unix Socket 通訊，而非 TCP 3306 埠。
• Node.js mysql 驅動預設嘗試 TCP 連線，找不到 Socket 導致拒絕連線。
• 指定正確的 mysql.sock 路徑即可繞過 TCP 直連 Socket，解決問題。

常見 Socket 路徑

若不確定路徑，可執行 mysql_config --socket 或查看 my.cnf 中 socket 參數。

1. 上一篇文章： MySQL 入門到實戰總結：DBMS 概念、資料類型、DDL/DML、常用命令與工具
2. 下一篇文章： MySQL 效能優化持續更新清單：快取、索引、SQL 寫法、架構 20+ 條核心要點

MySQL 綜合教學

MySQL 查詢優化技巧：LIMIT 1 避免全表掃描提升效能

在明確查詢結果唯一（或只需第一筆）的場景下，給 SQL 加上

從 MSSQL 遷移 MySQL 語法差異全對比 (二)：顯示寬度 INT(11) 真相

核心結論 MySQL 的整數顯示寬度 (如 INT(11))

超詳細 MySQL 圖文安裝教程：Custom 自定義安裝與常見錯誤排查

超詳細 MySQL 圖文安裝教程：Custom 自定義安裝與

MySQL 查詢結果複製到新表：UPDATE 更新與 INSERT 插入實戰

在 MySQL 中，將一張表的查詢結果同步到另一張表是常見需