MongoDB 6.0 WiredTiger 缓存大小通过配置文件 mongod.conf 中的 storage.wiredTiger.engineConfig.cacheSizeGB 参数调整，默认值为可用物理内存的 50%。生产环境建议预留至少 20% 内存给操作系统，避免设置超过物理内存的 80% 以防 OOM。

命令速用版

修改 MongoDB 配置文件 mongod.conf，在 storage.wiredTiger.engineConfig 下添加 cacheSizeGB 参数，单位为 GB。

storage:\n  wiredTiger:\n    engineConfig:\n      cacheSizeGB: 4

若需通过启动命令临时调整，可使用 wiredTigerCacheSizeGB 参数，但重启后失效。

mongod `--wiredTigerCacheSizeGB` 4

为什么会这样

WiredTiger 引擎同时使用内部缓存和操作系统文件系统缓存，默认配置旨在平衡两者。

默认情况下，WiredTiger 内部缓存大小为 50% 的 (RAM - 1 GB) 或 0.256 GB 中的较大者。设置过大可能导致操作系统内存不足触发 OOM，设置过小则增加磁盘 I/O 压力。容器环境中，WiredTiger 可能无法正确识别 cgroup 内存限制，需手动指定具体数值。

分步处理

按以下步骤调整缓存大小并确保配置生效。

1. 检查当前缓存配置

在 MongoDB Shell 中执行以下命令，查看 maximum bytes configured 确认当前上限。

db.serverStatus().wiredTiger.cache

2. 编辑配置文件

打开 mongod.conf，找到 storage.wiredTiger.engineConfig 段落。若不存在则新建，确保缩进正确。

3. 重启服务

配置修改后需重启 mongod 服务生效。生产环境请在维护窗口操作。

4. 验证新配置

重启后再次执行 db.serverStatus().wiredTiger.cache，确认 maximum bytes configured 已更新为设定值。

怎么验证是否生效

重点监控缓存使用率及脏页比例，判断配置是否合理。

执行 db.serverStatus().wiredTiger.cache，关注以下字段：

• bytes currently in the cache：当前缓存数据量，持续接近 maximum bytes configured 说明缓存偏小。
• tracked dirty bytes in the cache：脏页数据量，占比过高可能阻塞写操作。
• pages evicted by age：因老化淘汰的页数，数值过高说明缓存淘汰频繁。

常见坑

配置缓存大小时需避开以下场景陷阱。

• 容器内存限制：在 Docker 或 Kubernetes 中，WiredTiger 可能读取宿主机内存而非容器限制，必须手动设置 cacheSizeGB。
• GridFS 并发瓶颈：GridFS 写入慢的根本原因可能是元数据锁竞争或日志刷盘，仅调大缓存无法解决并发写入瓶颈。
• 云数据库限制：托管型 MongoDB 实例通常限制缓存大小为实例内存的 60%，不支持自定义修改。
• 内存交换风险：cacheSizeGB 设置超过物理内存 80% 可能导致系统使用 swap，显著降低性能。

常见问题

默认缓存大小是多少？

默认值为可用物理内存的 50%。

具体计算逻辑为 50% 的 (RAM - 1 GB) 与 0.256 GB 取较大值。

如何查看当前缓存使用量？

使用 db.serverStatus().wiredTiger.cache 命令查看。

返回结果中的 bytes currently in the cache 字段即为当前缓存占用字节数。

云数据库能修改缓存大小吗？

大多数云数据库实例不支持修改，缓存大小由实例规格决定。

云厂商通常将存储引擎缓存限定为实例内存的 60%，需升级实例规格间接调整。

参考来源

• 常见问题解答：适用于自管理部署的 MongoDB 存储
• 如何在 MongoDB 中配置 WiredTiger 的缓存大小？- 腾讯云开发者社区
• 如何优化 MongoDB 6.0 GridFS 的并发写入性能_调整 WiredTiger 缓存大小
• MongoDB 内存数据库配置全攻略：性能优化与最佳实践