MongoDB连接突发Bad Auth认证失败错误如何排查

你遇到的MongoServerError: bad auth : Authentication failed（错误码8000，AtlasError）是MongoDB Atlas在连接握手阶段直接返回的认证失败错误，结合你「服务稳定运行2个月、无代码改动突然报错」的场景，按出现概率从高到低，诱因和对应解决方法如下：

• 数据库用户凭据失效（最高概率）
  这是这类无预兆认证失败的最常见原因：
  • Atlas项目/组织开启了默认安全策略，自动定期轮换数据库用户密码（默认周期通常为90天）
  • 同项目的其他管理员误修改、删除了服务使用的数据库用户，或重置了该用户的密码
    解决方法：登录Atlas控制台进入数据库用户管理页面，找到服务使用的数据库用户直接重置密码，重新从控制台复制完整连接串替换项目内的配置，重启服务即可恢复，90%以上的同类问题通过这一步就能解决。
• 运行时加载的连接配置被覆盖
  很多时候配置文件里写的URI是正确的，但服务实际运行时加载的配置存在错误：
  • 部署平台（容器平台、PaaS平台、物理服务器）的环境变量在更新、重启、重新部署时被意外修改，比如复制时多了首尾空格、密码部分的特殊字符缺失、被其他同名环境变量覆盖
    解决方法：在服务启动时打印加载到的MongoDB连接串（注意隐藏密码中间段，避免明文泄露），和控制台复制的URI逐段比对，确认配置加载逻辑正常。
• 动态凭据过期（低概率）
  如果你没有使用常规的SCRAM账号密码认证，而是用了IAM角色认证、X.509证书认证、OIDC认证这类动态凭据方式，凭据过期、证书被吊销后也会突然出现认证失败，重新轮换有效凭据即可。

排查提示：你提到已经配置了任意IP访问，不需要在网络规则上浪费排查时间——IP不在白名单的错误会明确提示IP不在白名单范围，不会返回bad auth类错误。另外驱动版本不兼容、连接参数配置错误这类问题会在服务首次启动、依赖升级后立刻触发，不会稳定运行2个月后无征兆出现。

内容的提问来源于stack exchange，提问作者Christy