Node.js日志中数据库连接失败怎么解决

在 Node.js 项目里遭遇数据库连接失败，这事儿其实挺常见的。别急，咱们一步步来排查，通常跑不出下面这几个原因。

1. 先检查数据库配置——这是最容易被忽略的细节。主机名、端口、用户名、密码、数据库名称，一个字符都不能错。拼写错误、大小写不敏感、漏了个下划线，都可能让连接直接挂掉。

2. 确认数据库服务器确实在跑。听起来像废话？但有时候服务器因为内存不足、日志满了或者计划重启而停掉，你都不知道。如果不确定，直接重启一下数据库服务，往往能瞬间解决问题。

3. 网络连通性要打通。如果你的 Node 应用和数据库不在同一台机器上（比如远程数据库），那就得确保网络是通的。本地开发还好，生产环境里常有安全组规则或 VPC 隔离导致连接超时——用 ping 或 telnet 测一下端口就知道了。

4. 防火墙设置是隐形杀手。无论数据库在云上还是自建机房，防火墙规则都可能把合法连接拦在外面。记得检查出站规则（应用侧）和入站规则（数据库侧），确保端口（默认 MySQL 是 3306，MongoDB 是 27017）是开放的。

5. 数据库驱动对吗？装了吗？ 很多新手会栽在这里：用 MongoDB 却忘了装 mongodb 包，用 MySQL 却没装 mysql2 或 mysql。驱动版本不匹配也可能导致连接失败，比如 MySQL 8 需要 mysql2 的最新版才能支持 caching_sha2_password 认证。

6. 别忽略错误日志——它是最直接的线索。Node 控制台输出的堆栈信息要仔细看，数据库本身的日志（比如 MySQL 的 error log）也值得翻一翻。很多问题其实日志里已经说得明明白白了，只是大家总习惯跳过。

7. 连接超时设置太短也可能酿成“假失败”。如果你的数据库响应慢（例如冷启动、查询复杂），默认的几秒超时可能不够。尝试把 connectTimeout 或 acquireTimeout 适当调大一点，比如 10 秒或 15 秒，问题往往迎刃而解。

8. 并发连接数别超限。数据库服务对最大连接数有限制，比如 MySQL 默认是 151。如果你的应用用了连接池且池大小设置过大，或者多个实例同时疯狂建立连接，很容易触发上限。检查一下连接池配置，一般建议设为 10～50，具体看业务压力。

如果上面这些你都逐一排查过了，问题还是没解决——那可能需要你提供更具体的上下文：比如数据库类型、连接代码片段、完整的错误堆栈。把这些信息贴出来，别人才能帮你精准定位。不过放心，90% 的数据库连接故障，逃不出上面这张清单。