Node.js日志中数据库连接问题怎么查

Node.js 日志定位数据库连接问题的实操流程

一、先定位日志中的错误类型

• 在应用日志中快速检索关键字：Error、ECONNREFUSED、ETIMEDOUT、ENOTFOUND、ER_ACCESS_DENIED_ERROR、ER_NOT_SUPPORTED_AUTH_MODE、MongoNetworkError、Authentication failed。这些关键词通常直接指向问题类别（网络、认证、超时、配置等）。
• 同时查看数据库服务端日志，获取更详细的失败原因：
  • MySQL：常见路径为 /var/log/mysql/error.log
  • MongoDB：查看 mongod 日志（由 systemd 管理时可用 journalctl -u mongod）
• 若使用 Ubuntu/Debian，可用 sudo systemctl status <service> 检查数据库服务是否运行，并配合 sudo journalctl -u <service> -f 实时跟踪日志。

二、按错误类型对照排查

三、环境与网络层面的核验

• 确认数据库服务处于活动状态：
  • MySQL：sudo systemctl status mysql，未运行则 sudo systemctl start mysql
  • MongoDB：sudo systemctl status mongod，未运行则 sudo systemctl start mongod
• 核对数据库监听地址：
  • MySQL：在 /etc/mysql/mysql.conf.d/mysqld.cnf 检查 bind-address，需要远程访问时设为 0.0.0.0 并重启服务
• 防火墙与安全组：
  • UFW：sudo ufw allow <port>/tcp（如 3306 或 27017）
  • 云上实例需同时放行云安全组对应端口
• 网络连通性测试：
  • ping <db_host>、telnet <db_host> <port> 或 nc -vz <db_host> <port> 验证端口可达性

四、代码与配置层面的检查

• 配置正确性：逐项核对 host、port、user、password、database，避免拼写与类型错误（如端口写成字符串）。
• 驱动与版本：确保驱动与数据库版本匹配（如 MySQL 8.0 建议用 mysql2）。
• 连接池与健康检查：
  • 合理设置 connectionLimit、acquireTimeoutMillis、idleTimeoutMillis
  • 启动时做一次性连接校验，运行期对连接错误进行 log + 告警/重试
• 异步与错误边界：
  • 使用 async/await 或 Promise 正确捕获连接/查询错误
  • Express 全局错误中间件记录堆栈：app.use((err, req, res, next) => { console.error(err.stack); res.status(500).send('Something broke!'); })
• 最小化复现脚本：用一段只包含连接逻辑的最小脚本直连数据库，排除业务代码干扰。

五、5 分钟应急清单

• 在应用日志中 grep 关键字：Error / ECONNREFUSED / ETIMEDOUT / ER_ACCESS_DENIED_ERROR / ER_NOT_SUPPORTED_AUTH_MODE / MongoNetworkError。
• 在服务器上确认数据库运行：sudo systemctl status mysql（或 mongod），必要时 sudo systemctl restart mysql。
• 放行端口：sudo ufw allow 3306/tcp（或 27017），并检查云安全组。
• 直连测试：mysql -h <host> -P <port> -u <user> -p 或 mongo --host <host> --port <port>。
• 若报 ER_NOT_SUPPORTED_AUTH_MODE，优先安装 mysql2 或调整用户认证方式。
• 复核连接池与超时配置，确保连接可复用且异常时有 重试与告警。