MongoDB作为一款流行的NoSQL数据库，以其灵活的文档模型和易用性受到开发者喜爱。但对新手而言，由于缺乏关系型数据库的“表/列”思维，或对MongoDB语法细节不熟悉，很容易在日常操作中踩坑。本文总结几个最常见的错误场景，帮你快速避坑。
一、连接数据库时的“第一关”¶
1. 连接被拒绝（Connection Refused）
- 现象：执行 mongo 命令或代码连接MongoDB时，终端提示 Could not connect to server [localhost:27017]。
- 原因：MongoDB服务未启动，或端口被占用，或连接字符串格式错误。
- 解决方法：
- 检查服务状态：
- Linux/Mac：执行 sudo systemctl status mongod（查看MongoDB状态），若未启动则用 sudo systemctl start mongod 启动。
- Windows：在“服务”列表中找到MongoDB，手动启动。
- 确认端口：默认端口为27017，若被其他程序占用（如Redis），可通过 netstat -tuln | grep 27017 查看占用情况，或修改MongoDB配置文件（mongod.conf）指定新端口。
- 修正连接字符串：格式应为 mongodb://[主机]:[端口]/[数据库名]，例如本地连接：mongodb://localhost:27017/testdb（替换为实际数据库名）。
二、数据插入：“文档必须有归属”¶
1. 忘记指定集合名
- 现象：执行 db.insert({name: "Alice"}) 时报错 ReferenceError: insert is not defined。
- 原因：MongoDB的操作需显式指定集合（类似关系型数据库的“表”），新手常混淆“集合”和“数据库”。
- 解决方法：
- 方法1：先切换到目标集合（需先 use 数据库名）：
use testdb // 切换到testdb数据库
db.users.insertOne({name: "Alice", age: 25}) // 插入到users集合
- 方法2：直接用集合名前缀：
db.testdb.users.insertOne({name: "Alice", age: 25}) // 无需提前use
2. 重复插入导致_id冲突
- 现象：手动指定 _id 并重复插入同一文档，报错 E11000 duplicate key error。
- 原因：MongoDB的 _id 是自动生成的唯一键（默认类型为ObjectId），若手动设置且重复，会触发冲突。
- 解决方法：
- 避免手动设置 _id，依赖MongoDB自动生成。
- 若需自定义，确保值唯一（如用UUID、时间戳等）。
// 错误示例：手动设置重复_id
db.users.insertOne({_id: 1, name: "Alice"})
db.users.insertOne({_id: 1, name: "Bob"}) // 重复_id，报错！
// 正确示例：不手动设置_id
db.users.insertOne({name: "Alice"}) // MongoDB自动生成唯一_id
三、查询与更新：“条件和操作符的陷阱”¶
1. 查询条件“类型不匹配”
- 现象：用 db.users.find({age: 25}) 查不到数据，但确认数据存在。
- 原因：age 字段存储为字符串（如 "25"），而查询条件用了数字 25，类型不匹配。
- 解决方法：确保查询条件类型与存储类型一致。
// 若age存为字符串
db.users.find({age: "25"}) // 正确
// 若需按数字比较，可转换存储类型：
db.users.updateMany({}, {$set: {age: NumberInt(age)}}) // 统一转为数字
2. 更新操作“全集合覆盖”
- 现象：执行 db.users.updateOne({}, {$set: {name: "NewName"}}) 后，所有用户的 name 都被改为 NewName。
- 原因：更新条件为空对象 {}，MongoDB会匹配集合中所有文档。
- 解决方法：务必添加筛选条件，仅更新目标文档。
// 正确示例：只更新age=25的用户
db.users.updateOne({age: 25}, {$set: {name: "NewName"}})
四、数据类型：“无模式≠无规则”¶
MongoDB是“无模式”数据库，但字段类型（如字符串、数字、布尔值）仍需一致，否则会导致查询/统计失败。
1. 布尔值与数字混用
- 现象：用 db.users.find({isActive: 1}) 查不到 isActive: true 的数据。
- 原因：isActive 存储为布尔值 true，但查询条件用了数字 1。
- 解决方法：严格使用类型匹配，布尔值统一用 true/false。
2. 日期类型存储错误
- 现象：查询“最近3天数据”时结果为空，数据存储为字符串（如 "2023-10-01"）。
- 原因：字符串无法与 new Date() 直接比较。
- 解决方法：存储时用MongoDB的 Date 类型，查询时用 new Date()。
// 存储日期
db.users.insertOne({name: "Alice", createTime: new Date()}) // 自动转为Date类型
// 查询最近3天
const threeDaysAgo = new Date(Date.now() - 3 * 24 * 60 * 60 * 1000);
db.users.find({createTime: {$gte: threeDaysAgo}})
五、索引：“用对索引能提速10倍”¶
1. 重复创建索引
- 现象：执行多次 db.users.createIndex({name: 1})，MongoDB仅警告但不报错，但索引重复会浪费性能。
- 原因：重复执行 createIndex 时，MongoDB允许“覆盖”，但索引冗余。
- 解决方法：查询已存在的索引，避免重复创建。
// 查看集合所有索引
db.users.getIndexes()
// 若已存在name索引，跳过创建
if (!db.users.getIndexes().some(idx => idx.name === "name_1")) {
db.users.createIndex({name: 1})
}
六、其他新手“隐藏坑”¶
1. 版本兼容性问题
- 现象：用 db.collection.find({$expr: {$gt: ["$a", "$b"]}}) 报错语法错误。
- 原因：$expr 操作符需MongoDB 3.2+支持，若用旧版本（如3.0）则不兼容。
- 解决方法：升级MongoDB版本，或改用兼容语法（如3.0中用 $where 函数）。
2. 权限不足导致操作失败
- 现象：连接MongoDB后执行插入/更新操作，提示 not authorized on db to execute command。
- 原因：未启用权限验证（或用户无操作权限）。
- 解决方法：
- 本地开发可禁用权限（mongod --auth 不启动时，权限验证默认关闭）；
- 生产环境需创建用户并授权：
use admin
db.createUser({user: "admin", pwd: "password", roles: ["root"]}) // 创建管理员
db.auth("admin", "password") // 登录验证
总结¶
MongoDB的“灵活性”易让新手忽视细节，但只要记住：连接前确认服务状态、插入指定集合、查询匹配类型、索引避免重复，就能避免90%的基础错误。遇到问题时，优先查阅MongoDB官方文档或用 explain() 分析查询计划，逐步熟悉后就能高效避坑！