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() 分析查詢計劃，逐步熟悉後就能高效避坑！