Kotlin Spring Boot连接MongoDB Atlas遇bad auth错误排查求助

• 认证凭证错误
  直接核对MongoDB Atlas控制台里创建的数据库用户的用户名和密码，别搞混你的Atlas账号密码。如果密码里有@、:这类特殊字符，必须做URL编码后再填到配置里，同时检查有没有复制时多了空格或者漏了字符。

• 连接字符串配置冲突
  别同时混用完整连接URI和单独的用户名/密码配置，二选一就行：要么用spring.data.mongodb.uri填完整的srv格式链接，要么分开配置host、port、username、password、database。URI格式要准确：mongodb+srv://<用户名>:<编码后的密码>@集群地址/<数据库名>?retryWrites=true&w=majority。

• IP白名单未放行
  登录Atlas控制台看看你的服务器/本地IP有没有加到项目的IP白名单里，没加的话Atlas直接拒绝连接，有时候就会抛出bad auth的误导性错误。测试阶段可以临时加0.0.0.0/0，生产环境一定要改成具体IP。

• 数据库用户权限不足
  确认Atlas里的数据库用户是否有目标数据库的读写权限，权限不够也可能触发认证失败的提示，别只给了只读权限或者配错了数据库。

• 依赖版本不兼容
  检查Spring Boot和MongoDB驱动的版本匹配度，比如Spring Boot 3.x要搭配MongoDB驱动4.x及以上，旧驱动可能不支持Atlas用的SCRAM-SHA-256认证协议。直接用Spring Boot的starter依赖让它自动管理版本就行：

  implementation("org.springframework.boot:spring-boot-starter-data-mongodb")
  

• 代码配置细节错误
  核对数据模型的@Document注解，确保指定的集合名和数据库名和Atlas里的一致；仓库接口要正确继承MongoRepository；主类的@SpringBootApplication要能扫描到Mongo相关组件，避免仓库没被加载导致的异常。

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