Spring Boot 3.x 集成 MongoDB 的 默认配置项及默认值，以及 常用需要修改的配置项 的详细说明
以下是 Spring Boot 3.x 集成 MongoDB 的 默认配置项及默认值，以及 常用需要修改的配置项 的详细说明：
一、默认配置项及默认值
Spring Boot 对 MongoDB 的默认配置基于 spring.data.mongodb 前缀，以下是核心配置项：
| 配置项 | 默认值 | 描述 |
|---|---|---|
spring.data.mongodb.database | test | 默认连接的数据库名。 |
spring.data.mongodb.host | localhost | MongoDB 服务器地址。 |
spring.data.mongodb.port | 27017 | MongoDB 默认端口。 |
spring.data.mongodb.username | 空 | 连接认证的用户名（需启用认证时配置）。 |
spring.data.mongodb.password | 空 | 连接认证的密码（需启用认证时配置）。 |
spring.data.mongodb.authentication-database | admin | 认证使用的数据库（如需指定认证数据库）。 |
spring.data.mongodb.uri | 空 | MongoDB 连接字符串（优先级高于单独配置的 host/port 等）。 |
spring.data.mongodb.repositories.enabled | true | 是否启用 MongoDB 仓库（Repository）支持。 |
spring.data.mongodb.auto-index-creation | true | 是否自动创建索引（基于 @Indexed 注解）。 |
二、常用需要修改的配置项及说明
以下配置项根据实际场景需要调整：
1. 连接基础配置
# MongoDB 连接字符串（推荐使用，简化配置）
spring.data.mongodb.uri=mongodb://localhost:27017/mydb
# 或单独配置（适用于简单场景）
spring.data.mongodb.host=localhost
spring.data.mongodb.port=27017
spring.data.mongodb.database=mydb
2. 认证配置
# 启用认证（需 MongoDB 服务已配置用户名/密码）
spring.data.mongodb.username=admin
spring.data.mongodb.password=admin123
spring.data.mongodb.authentication-database=admin # 认证数据库（默认 admin）
3. 连接池配置
# 连接池最大连接数（默认 100）
spring.data.mongodb.max-connections-per-host=100
# 连接超时时间（毫秒，默认 10000ms）
spring.data.mongodb.connect-timeout=10000
# 读取超时时间（毫秒，默认 10000ms）
spring.data.mongodb.socket-timeout=10000
4. 高级连接配置
# 启用 SSL（需 MongoDB 服务支持 SSL）
spring.data.mongodb.ssl-enabled=true
# 忽略 SSL 主机名验证（测试环境可用）
spring.data.mongodb.ssl-invalid-host-name-allowed=true
# 副本集名称（若使用副本集）
spring.data.mongodb.replica-set=my-replica-set
# 分片集群配置（若使用分片）
spring.data.mongodb.sharded=true
5. 写操作配置
# 写操作确认级别（默认 `ACKNOWLEDGED`）
spring.data.mongodb.write-concern=MAJORITY # 确保写入到多数节点
# 读操作模式（默认 `PRIMARY`）
spring.data.mongodb.read-concern=MAJORITY
spring.data.mongodb.read-preference=primary
6. 其他优化配置
# 自动创建索引（根据 @Indexed 注解）
spring.data.mongodb.auto-index-creation=true
# 关闭自动索引创建（避免重复索引）
spring.data.mongodb.auto-index-creation=false
三、配置示例
场景 1：本地 MongoDB（无认证）
spring.data.mongodb.uri=mongodb://localhost:27017/myapp
场景 2：远程 MongoDB（带认证）
spring.data.mongodb.uri=mongodb://user:pass@remote-host:27017/mydb?authSource=admin
场景 3：副本集配置
spring.data.mongodb.uri=mongodb://host1:27017,host2:27017,host3:27017/mydb?replicaSet=my-replica-set
场景 4：SSL 连接
spring.data.mongodb.uri=mongodb://user:pass@host:27017/mydb?ssl=true&sslInvalidHostNameAllowed=true
四、注意事项
-
优先级规则
spring.data.mongodb.uri的优先级高于单独配置的host/port等参数。- 若同时配置
uri和其他参数，其他参数会被忽略。
-
连接池优化
- 根据应用负载调整
max-connections-per-host（通常 100 足够，高并发场景可适当增加）。 - 避免设置过小的连接超时（
connect-timeout）导致频繁断开。
- 根据应用负载调整
-
安全配置
- 生产环境必须启用认证和 SSL。
- 避免使用
sslInvalidHostNameAllowed在生产环境（可能有安全风险）。
-
索引管理
- 开发阶段可启用
auto-index-creation，生产环境建议手动创建索引以避免重复。
- 开发阶段可启用
五、完整配置参考
# 基础配置
spring.data.mongodb.uri=mongodb://user:pass@host:27017/mydb?authSource=admin&replicaSet=my-replica-set&ssl=true
# 连接池
spring.data.mongodb.max-connections-per-host=200
spring.data.mongodb.min-connections-per-host=4
# 超时配置
spring.data.mongodb.connect-timeout=5000
spring.data.mongodb.socket-timeout=30000
# 认证与安全
spring.data.mongodb.ssl-enabled=true
spring.data.mongodb.ssl-invalid-host-name-allowed=false
# 写操作
spring.data.mongodb.write-concern=MAJORITY
# 索引
spring.data.mongodb.auto-index-creation=true
通过以上配置，可以灵活适配不同场景的 MongoDB 集成需求。