Ubuntu JS日志中数据库连接问题如何解决

Ubuntu Node.js 日志中的数据库连接问题排查与修复

一 快速定位流程

• 确认数据库服务是否运行：例如 MySQL 使用命令：sudo systemctl status mysql；未运行则启动：sudo systemctl start mysql。注意在 Ubuntu 上服务名通常是 mysql，而不是 mysqld。
• 核对连接配置：检查 host、port、user、password、database 是否正确，避免因配置错误导致连接被拒绝。
• 检查防火墙：使用 UFW 放行数据库端口（如 3306）：sudo ufw allow 3306。
• 校验数据库用户权限：确保用户具备从应用所在主机连接的权限，必要时授予并刷新权限。
• 测试网络连通性：对数据库主机执行 ping your_db_host 排查网络问题。
• 查看详细日志：同时查看 Node.js 应用日志 与 数据库错误日志，获取具体错误原因。
• 重启服务：变更后重启 Node.js 应用 与 数据库服务 使配置生效。

二 常见错误与对应修复

• 服务未启动或名称错误：日志提示 “Connection refused/Can’t connect”。先用 sudo systemctl status mysql 确认状态；若提示找不到服务，改用 mysql 而非 mysqld。
• 配置错误：日志出现 “Access denied for user …” 或 “ER_ACCESS_DENIED_ERROR”。核对 host/port/user/password/database，必要时在代码中打印配置（避免泄露密码到生产日志）。
• 防火墙阻断：日志显示超时或无法建立连接。使用 sudo ufw allow 3306 放行数据库端口，或临时关闭防火墙验证。
• 权限不足：日志提示 “Access denied”。在数据库中执行 SELECT User, Host FROM mysql.user; 查看允许的主机，使用 GRANT … TO ‘user’@‘host’ IDENTIFIED BY ‘pwd’; FLUSH PRIVILEGES; 授予权限。
• 网络不通：日志显示 “ETIMEDOUT” 或 “ENOTFOUND”。执行 ping your_db_host 检查连通性，排查 VPC/安全组/路由 等网络策略。
• 驱动或认证不兼容：如 MySQL 8.0 默认使用新的认证插件，旧驱动可能报认证失败。升级驱动（如 mysql2/promise），或在创建用户时指定兼容的认证方式（如 mysql_native_password）。

三 日志与诊断命令清单

• 服务状态：
  • 查看：sudo systemctl status mysql
  • 启动：sudo systemctl start mysql
• 防火墙：
  • 放行端口：sudo ufw allow 3306
• 数据库权限：
  • 查看用户与主机：SELECT User, Host FROM mysql.user;
  • 授权并刷新：GRANT ALL PRIVILEGES ON your_db. TO ‘app’@‘your_host’ IDENTIFIED BY ‘pwd’; FLUSH PRIVILEGES;*
• 网络连通性：
  • 测试主机可达：ping your_db_host
• Node.js 日志查看：
  • 实时查看：tail -f your_app.log
  • 使用 PM2：pm2 logs
• 系统日志：
  • 查看服务日志：journalctl -u your_node_service 或 journalctl -u mysql
• 数据库错误日志：
  • 常见路径在 /var/log/mysql/error.log 或 /var/log/mysql/ 目录下，依据实际配置定位。

四 代码与配置优化建议

• 使用 Promise/async-await 正确处理异步连接，避免回调地狱与未捕获异常：
  • 示例（mysql2/promise）：
    • const mysql = require(‘mysql2/promise’);
    • const conn = await mysql.createConnection({ host:‘localhost’, user:‘u’, password:‘p’, database:‘db’ });
• 配置连接池并合理设置上限，避免连接风暴：
  • 示例：
    • const pool = mysql.createPool({ host:‘localhost’, user:‘u’, password:‘p’, database:‘db’, connectionLimit:10 });
• 统一日志输出，便于定位：
  • 使用 Winston 输出结构化日志，区分 error/info，并写入文件便于排查。
• 变更后重启：
  • 重启应用与数据库：sudo systemctl restart your_node_service，sudo systemctl restart mysql。

五 最小可复现实例与验证

• 安装依赖：
  • npm i mysql2/promise
• 连接测试脚本（test-db.js）：
  • const mysql = require(‘mysql2/promise’);
  • (async () => {
    • try {
      • const conn = await mysql.createConnection({ host:‘localhost’, user:‘test’, password:‘pwd’, database:‘testdb’, port:3306 });
      • console.log(‘Connected’); await conn.end();
      • } catch (err) {
        • console.error(‘Connect error:’, err);
      • }
    • })();
• 验证步骤：
  • 确认 MySQL 运行：sudo systemctl status mysql
  • 放行端口：sudo ufw allow 3306
  • 创建测试用户与库并授权：
    • CREATE DATABASE IF NOT EXISTS testdb;
    • CREATE USER ‘test’@‘localhost’ IDENTIFIED BY ‘pwd’;
    • GRANT ALL PRIVILEGES ON testdb.* TO ‘test’@‘localhost’; FLUSH PRIVILEGES;
  • 运行脚本并观察输出；若失败，结合 应用日志 与 数据库错误日志 定位。