在 CentOS 上部署 Node.js 项目时 最让人抓狂的往往不是写业务代码，而是那层层叠叠的数据库连接设置。别慌！下面这篇文章把「装配」「调优」「平安」三个关键词揉进了一个完整的实战案例， 帮你把繁琐的步骤化繁为简，让你的服务器像装了涡轮增压一样飞速响应，我无法认同...。

一、 先把基石铺好：系统、MySQL 与 Node.js

1. 更新系统并安装必备工具

# 更新所有软件包
sudo yum update -y
# 安装常用工具
sudo yum install -y vim git wget curl

2. 安装 MySQL并启动服务

如果你的机器上还没有 MySQL，直接甩出下面这几行命令，几分钟就能跑起来：

sudo yum install -y mysql-server
sudo systemctl start mysqld
sudo systemctl enable mysqld

启动后用 root 账号登录检查：

mysql -u root -p

3. 创建专用库和用户

CREATE DATABASE my_database CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'my_user'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON my_database.* TO 'my_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4. 安装最新的 Node.js

绝绝子... Node.js 的版本更新太快，建议使用官方脚本一键装好 LTS 版：

curl -sL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs
node -v   # 确认版本
npm -v    # 确认 npm 可用

二、Node.js 项目里怎么优雅地连上 MySQL？

1. 初始化项目并安装 mysql 模块

# 新建目录并进入
mkdir myapp && cd myapp
# 初始化 npm 项目
npm init -y
# 安装官方推荐的 mysql2
npm install mysql2 --save

2. 把配置信息抽离到 .env 中， 别让密码硬编码在代码里

.env 文件示例：

# .env 文件放在项目根目录，务必加入 .gitignore
DB_HOST=localhost
DB_USER=my_user
DB_PASSWORD=my_password
DB_不结盟E=my_database
DB_CONNECTION_LIMIT=15   # 连接池最大数量，可根据业务调节

接着在代码里使用 加载：

# 安装 dotenv 包
npm install dotenv --save
# 在入口文件  开头写入：
require.config;

3. 建立连接池——高并发下的黄金法则

单个连接只能处理一次查询，面对上百并发请求时会瞬间卡死。使用连接池可以让多个查询共享有限资源，却又不至于互相抢占。

// db.js —— 专门负责创建与导出 pool 实例
const mysql = require;
require.config;
const pool = mysql.createPool({
    host     : process.env.DB_HOST,
    user     : process.env.DB_USER,
    password : process.env.DB_PASSWORD,
    database : process.env.DB_不结盟E,
    waitForConnections: true,
    connectionLimit   : parseInt || 10,
    queueLimit        : 0   // 不限制排队数， 必要时自行调节
});
module.exports = pool;

4. 用 async/await 写业务查询——代码更干净、更易读

// example.js —— 演示一次查询流程
const pool = require;
async function getUsers {
    const sql = 'SELECT id, username, email FROM users WHERE status = ?';
    const status = 'active';
    try {
        const  = await pool.execute;
        console.log;
        return rows;
    } catch  {
        console.error;
        // 根据错误类型决定是否重试或告警...
        throw err;
    }
}
// 调用示例：
getUsers.n);

三、性能调优小技巧

1️⃣ 调整 `connectionLimit` 与 `queueTimeout` 配合使用 :

// 在 db.js 中加入超时设置
const pool = mysql.createPool({
    // …前面的配置保持不变…
    acquireTimeout : 10000,          // 获取连接超时时间
    enableKeepAlive: true,
});

2️⃣ 使用事务时记得手动提交或回滚 :

// transaction-demo.js
const pool = require;
async function transfer {
    const conn = await pool.getConnection;
    try {
        await conn.beginTransaction;
        await conn.query;
        await conn.query;
        await conn.commit;
        console.log;
    } catch  {
        await conn.rollback;
        console.error;
    } finally {
        conn.release;   // 别忘了归还连接！
    }
}
transfer;

四、 常见错误 & 排查思路

事实上... 🔴EHOSTUNREACH / ECONNREFUSED： 检查防火墙是否放通3306端口，确认 MySQL 正在监听 . 🔴Error Code: 1045 ：** 用户名或密码错误？请确保 .env 中的凭证与 MySQL 中一致，并且用户主机限定为 localhost。 🔴Circular dependency in modules： 如果 db.js 与业务模块相互引用，请把 db 放到独立目录或使用惰性加载。 🔴SLOW QUERY detected： 打开慢查询日志，用 mysqldumpslow 分析 top‑10；接着给相关列加索引。 🔴Poor performance under load： 先查看 SHOW STATUS LIKE 'Threads_connected'; 再对比 max_connections 与 connectionLimit 是否匹配。 \ 如果你看到以上任何一种红灯， 就先停下来深呼吸，然后按顺序排查。记住每一步都要记录下来下次再遇到同样的问题，你已经有了「复盘」材料。\ \ 还有一点值得提醒：生产环境强烈建议开启 SSL 加密，以防网络窃听。只需在创建用户时加上 REQUIRE SSL 即可。\ \ 再说说 如果你觉得本篇文章帮到了你，请点个赞、分享给团队小伙伴，让大家一起摆脱「数据库连不上」的噩梦吧！🚀🚀🚀\ \