Debian Node.js 日志中的数据库连接问题

Debian 上 Node.js 数据库连接问题的排查与修复

一 快速定位流程

• 查看应用日志与系统日志：使用 journalctl -u 你的服务名、tail -f /var/log/syslog，必要时用 grep “error|timeout|ECONNREFUSED|ETIMEDOUT” 过滤关键字，先确定错误类型与时间点。
• 校验数据库服务状态与监听：确认数据库已启动并监听正确端口，必要时用 ss -lntp | grep 端口 或 netstat -tulpen | grep 端口 检查。
• 直连数据库做对照：在同一台机器或跳板机上用命令行客户端（如 mysql、mongosh）尝试连接，排除应用层干扰。
• 检查网络与防火墙：对远程库，验证 ping/ traceroute 可达性，开放数据库端口（如 3306 或 27017）的入站/出站规则。
• 复核连接配置与凭据：主机、端口、库名、用户名、密码、SSL/TLS、连接池参数逐一核对。
• 查看数据库服务器日志：MySQL 常见路径 /var/log/mysql/error.log，MongoDB 常见路径 /var/log/mongodb/mongod.log，从服务端错误码定位根因。
• 必要时重启应用并观察：修改配置后重启服务，持续 tail 日志确认是否恢复。

二 常见错误与对应修复

三 配置与代码检查清单

• 连接参数与环境变量：核对 host、port、database、username、password、ssl；多环境（dev/test/prod）下确保 NODE_ENV 与配置文件一致，避免凭据错配。
• 驱动与版本兼容：选择与数据库版本匹配的驱动（如 mysql2 支持 Promise 与更优性能）；MySQL 8 优先使用新驱动并处理好认证插件。
• 连接池与健康检查：设置合理 connectionLimit / max、idle、acquireTimeout、timeout；启用连接验证/回收策略，避免脏连接。
• 安全与网络：生产环境启用 TLS/SSL；仅开放必要端口；数据库与 Node.js 服务间使用最小权限账户；对公网访问加白名单与速率限制。
• 日志与可观测性：在应用侧结构化记录连接错误与重试；结合 journalctl 与数据库错误日志交叉验证。

四 最小可用示例 MySQL 连接

• 安装依赖：npm i mysql2/promise
• 示例代码（带超时与池化）：

// db.js
const mysql = require('mysql2/promise');

const pool = mysql.createPool({
  host: process.env.DB_HOST || '127.0.0.1',
  port: process.env.DB_PORT || 3306,
  user: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME,
  ssl: process.env.DB_SSL === 'true', // 生产建议开启
  connectionLimit: 10,
  connectTimeout: 10000,
  acquireTimeout: 10000,
  timeout: 30000
});

async function test() {
  let conn;
  try {
    conn = await pool.getConnection();
    const [rows] = await conn.execute('SELECT 1 AS ok');
    console.log('DB OK:', rows[0].ok);
  } catch (err) {
    console.error('DB ERROR:', err);
    throw err;
  } finally {
    if (conn) conn.release();
  }
}

module.exports = { pool, test };

• 运行验证：node -e “require(‘./db’).test()” 并观察日志输出。

五 需要你提供的关键信息

• 具体错误日志片段（包含错误码/关键字，如 ETIMEDOUT/ECONNREFUSED/ER_ACCESS_DENIED_ERROR）。
• 数据库类型与版本（如 MySQL 8.0、MongoDB 6.x）、Node.js 与驱动版本（如 mysql2 3.x）。
• 连接配置（脱敏后的 host/port/user/db 与是否启用 SSL）。
• 数据库与 Node.js 是否在同一台 Debian 主机、端口监听与防火墙策略概况。