Spring连接MongoDB副本集认证异常问题求助

我之前也碰到过好几次这种情况——明明用Mongo Shell能正常连数据库，Spring项目里却一直抛出认证异常，大概率是这几个容易忽略的细节出了问题，咱们一步步排查：

1. 认证数据库指定错误 #

Mongo Shell连接时，如果你的账号是在业务数据库（比如mydb）下创建的，Shell会默认用当前库做认证源；但Spring默认会用admin库来做认证，这就会导致不匹配。

解决办法： #

方式一：在连接URI中指定authSource

# application.properties
spring.data.mongodb.uri=mongodb://username:password@localhost:27017/mydb?authSource=mydb

方式二：在Java Bean配置中显式指定认证库

@Bean
public MongoClient mongoClient() {
    MongoCredential credential = MongoCredential.createScramSha1Credential(
        "username", 
        "mydb", // 这里指定你的账号所在的数据库
        "password".toCharArray()
    );
    MongoClientSettings settings = MongoClientSettings.builder()
        .applyToClusterSettings(builder -> 
            builder.hosts(Collections.singletonList(new ServerAddress("localhost", 27017)))
        )
        .credential(credential)
        .build();
    return MongoClients.create(settings);
}

2. 密码中的特殊字符未转义 #

如果你的密码包含@、&、%这类URL特殊字符，Mongo Shell里直接输入没问题，但Spring的连接URI里必须做URL转义，否则会被解析成URI的分隔符，导致密码错误。

解决办法： #

把特殊字符换成对应的URL编码，比如：

• @ → %40
• & → %26
• % → %25

示例URI：

spring.data.mongodb.uri=mongodb://myuser:mypass%40123@localhost:27017/mydb?authSource=mydb

3. 认证机制不匹配 #

MongoDB 3.0+默认用SCRAM-SHA-1，如果你的MongoDB集群配置了SCRAM-SHA-256认证，而Spring没有显式指定，就会出现认证失败。

解决办法： #

在URI中添加authenticationMechanism参数：

spring.data.mongodb.uri=mongodb://username:password@localhost:27017/mydb?authSource=mydb&authenticationMechanism=SCRAM-SHA-256

或者在Bean配置中指定：

@Bean
public MongoClient mongoClient() {
    MongoCredential credential = MongoCredential.createScramSha256Credential(
        "username", 
        "mydb", 
        "password".toCharArray()
    );
    // 后续配置同上...
}

4. Spring配置属性拼写错误 #

有时候只是简单的笔误，比如把spring.data.mongodb.password写成spring.data.mongodb.pass，或者URI里的参数名写错（比如把authSource写成authDb），都会导致认证失败。

排查技巧： #

把Spring里的完整连接URI复制到Mongo Shell里测试，比如：

mongo "mongodb://username:password@localhost:27017/mydb?authSource=mydb"

如果Shell里也连不上，那就是URI本身的问题；如果Shell能连，再回头检查Spring的配置是否有遗漏。

另外，可以开启MongoDB的认证日志（在mongod.conf里设置systemLog.verbosity=5），查看具体的认证失败原因，比如是“用户不存在”还是“密码错误”，能帮你更快定位问题。

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