MongoDB常见报错及解决方案
连接超时错误
MongoDB连接超时错误通常表现为“Connection timed out”或“No route to host”，这种错误可能由网络问题、防火墙设置或MongoDB服务未正确启动导致，检查网络连通性，使用ping命令测试MongoDB服务器的可达性，如果网络正常，确认防火墙是否允许MongoDB的默认端口27017，确保MongoDB服务已启动，可通过systemctl status mongod（Linux）或任务管理器（Windows）检查，若问题依旧，尝试调整连接超时参数，如socketTimeoutMS和connectTimeoutMS，在连接字符串中设置更长的超时时间。
认证失败错误
认证失败错误提示“Authentication failed”或未授权访问，通常与用户权限或凭据错误有关，确认用户名和密码是否正确，检查是否输入了错误的认证数据库，创建用户时指定了admin数据库，但连接时未指定或指定错误，验证用户权限是否满足操作需求，可通过db.getUser("username")查看用户权限，如果用户不存在或权限不足，需重新创建用户或赋予相应权限，检查MongoDB的认证机制是否启用，确保配置文件中的auth参数设置为true。
磁盘空间不足错误
磁盘空间不足错误表现为“Warning: Low Disk Space”或写入操作失败，MongoDB对磁盘空间要求较高，尤其是 WiredTiger 存储引擎，使用df -h命令检查磁盘剩余空间，确保可用空间足够，如果空间不足，可清理临时文件或归档旧数据，启用MongoDB的日志轮转功能，避免日志文件过大占用空间，对于生产环境，建议配置磁盘监控和告警，及时扩容或清理数据，检查oplog大小是否合理，过小的oplog可能导致复制延迟或写入失败。
内存不足错误
内存不足错误通常与MongoDB的内存管理有关，提示“Out of Memory”或查询性能下降，MongoDB依赖内存映射文件（MMAPv1）或WiredTiger的缓存机制，若物理内存不足，可能导致性能问题，检查系统内存使用情况，使用free -m（Linux）或任务管理器（Windows）监控内存占用，调整MongoDB的内存参数，如wiredTiger.cacheSizeGB，限制WiredTiger引擎的缓存大小，避免过度依赖操作系统缓存，合理分配内存资源，对于高并发场景，可考虑分片或读写分离，减轻单节点内存压力。
索引相关错误
索引错误常见于重复键或索引创建失败，插入文档时提示“DuplicateKeyError”，表示唯一索引冲突，需检查索引字段是否重复，或使用db.collection.getIndexes()查看索引定义，若索引创建失败，可能是字段类型不支持或内存不足，确保索引字段的数据类型一致，避免混合类型导致的错误，批量创建索引时，建议在低峰期操作，避免阻塞写入操作，对于大型集合，可使用background: true选项在后台创建索引，减少对性能的影响。
副本集错误
副本集错误可能涉及节点同步、选举或主从切换问题。“No primary found in set”表示副本集无法选举主节点，需检查各节点的网络连通性，确保replSet配置一致，使用rs.status()查看副本集状态，确认节点是否正常同步，若节点频繁切换，可能是网络延迟或心跳超时，调整heartbeatIntervalMillis和electionTimeoutMillis参数，确保所有节点的时钟同步，避免时间差导致的数据不一致问题。
查询性能问题
查询性能问题通常表现为慢查询或超时，使用db.collection.explain()分析查询计划，检查是否使用了索引，未使用索引的查询可能导致全表扫描，显著降低性能，优化索引设计，确保查询条件覆盖索引字段，对于复杂查询，考虑重写或分页处理，监控MongoDB的慢查询日志，通过slowms参数设置阈值，记录执行时间过长的查询，定期维护索引，重建碎片化索引以提高查询效率。
数据类型不匹配错误
数据类型不匹配错误常见于更新或查询操作，提示“cannot match query”或类型转换失败，字符串与数字比较时出现错误，需检查字段的数据类型是否一致，使用typeof或BSON类型工具验证数据，在插入或更新时，显式指定数据类型，避免隐式转换导致的问题，对于动态字段，建议使用BSON类型检查，如$type操作符确保类型匹配，应用程序应严格校验输入数据，避免非法类型写入数据库。
网络分区错误
网络分区错误可能导致副本集节点通信中断，提示“node is unreachable”或选举失败，需检查网络配置，确保节点间可以互相访问，使用ping或telnet测试端口连通性，排除防火墙或网络设备干扰，对于跨机房部署，考虑使用延迟较低的链路，或调整heartbeatTimeoutMillis参数，监控网络延迟和丢包率，及时处理网络抖动问题。
配置文件语法错误
配置文件语法错误可能导致MongoDB无法启动，提示“Failed to parse”或“invalid configuration”，需检查配置文件（如mongod.conf）的语法，确保缩进和格式正确，使用mongod --configtest验证配置文件有效性，常见错误包括端口号冲突、存储引擎参数错误或认证配置遗漏，建议使用官方文档对照配置，避免手误或拼写错误，对于复杂配置，可分模块测试，逐步排查问题。
FAQs
Q1: 如何解决MongoDB连接超时问题？
A: 首先检查网络连通性，确保防火墙允许27017端口，确认MongoDB服务已启动，并调整连接超时参数，如socketTimeoutMS: 30000，若问题持续，检查服务器负载或使用mongodump测试连接稳定性。
Q2: MongoDB认证失败时如何排查？
A: 验证用户名、密码及认证数据库是否正确，使用db.auth("username", "password")测试登录，检查用户权限，必要时重新创建用户并赋予相应角色，确保MongoDB启用认证模式，配置文件中auth: true。