Cách khắc phục lỗi 'ConflictingUpdateOperators' trong MongoDB

Vấn đề: Tại sao MongoDB chặn việc cập nhật nhiều lần trên cùng một đường dẫn

Bạn đang tập trung viết mã cho tính năng cập nhật hồ sơ người dùng thì đột nhiên, MongoDB dừng tiến trình với lỗi ConflictingUpdateOperators. Điều này xảy ra khi lệnh cập nhật của bạn cố gắng sửa đổi cùng một trường—hoặc các phần chồng chéo của cùng một đối tượng—bằng cách sử dụng nhiều toán tử cùng một lúc.

Lỗi này thường hiển thị như sau trong console của bạn:

Plan executor error during findAndModify :: caused by :: ConflictingUpdateOperators: Updating the path 'user_metadata' would create a conflict at 'user_metadata'

Tại sao điều này lại xảy ra? Công cụ cập nhật của MongoDB yêu cầu sự rõ ràng. Nó không thể đảm bảo thứ tự thực thi của các toán tử như $set, $inc, hoặc $push trong cùng một lệnh. Để ngăn chặn các trạng thái dữ liệu không thể dự đoán, nó chỉ đơn giản là từ chối bất kỳ thao tác nào nhắm mục tiêu vào cùng một trường hai lần.

Các nguyên nhân phổ biến gây ra lỗi này

Hầu hết các lập trình viên thường gặp phải vấn đề này theo một trong hai cách sau:

1. Sử dụng nhiều toán tử trên một trường duy nhất

Hãy tưởng tượng bạn đang xử lý một đơn hàng. Bạn muốn đánh dấu nó là "shipped" và đồng thời tăng bộ đếm phiên bản. Nếu bạn cố gắng nhắm mục tiêu vào cùng một trường bằng hai chỉ dẫn khác nhau, lệnh sẽ thất bại.

// Lệnh này sẽ THẤT BẠI
db.orders.updateOne(
  { _id: 101 },
  {
    $set: { "status": "shipped" },
    $inc: { "status": 1 } // Xung đột: 'status' đã bị sửa đổi bởi $set
  }
)

2. Sự chồng chéo giữa Cha và Con

Đây là phiên bản "tinh vi" của lỗi này. Nó xảy ra khi bạn cố gắng ghi đè toàn bộ một đối tượng trong khi cũng đang cố gắng cập nhật một thuộc tính cụ thể bên trong chính đối tượng đó.

// Lệnh này sẽ THẤT BẠI
db.users.updateOne(
  { _id: "user_v42" },
  {
    $set: { "profile": { "name": "Alice", "role": "admin" } },
    $set: { "profile.lastLogin": new Date() } // Xung đột: 'profile' và 'profile.lastLogin' bị chồng chéo
  }
)

Cách khắc phục

Phương pháp 1: Hợp nhất thành một đối tượng duy nhất

Khi sử dụng cùng một toán tử (như $set) trên các đường dẫn chồng chéo, cách khắc phục gọn gàng nhất là kết hợp chúng lại. Thay vì sử dụng hai đường dẫn riêng biệt, hãy cung cấp một đối tượng hoàn chỉnh cho trường cha.

Cách làm sai:

$set: { "settings": { "theme": "dark" } },
$set: { "settings.fontSize": 14 }

Cách làm đúng:

$set: {
  "settings": {
    "theme": "dark",
    "fontSize": 14
  }
}

Phương pháp 2: Sử dụng Dot Notation để đạt độ chính xác

Để tránh việc "khóa" toàn bộ đối tượng cha, hãy sử dụng dot notation để chỉ cập nhật các trường con cụ thể mà bạn cần. Đây là cách tiếp cận hiệu quả nhất vì nó không ghi đè lên các dữ liệu không liên quan bên trong đối tượng.

// An toàn và chính xác
db.users.updateOne(
  { _id: "user_v42" },
  {
    $set: {
      "profile.name": "Alice",
      "profile.role": "admin",
      "profile.lastLogin": new Date()
    }
  }
)

Phương pháp 3: Chuỗi các cập nhật tuần tự

Nếu bạn thực sự cần các toán tử khác nhau (như $inc cho bộ đếm và $set cho trạng thái) trên cùng một trường, bạn phải chia chúng thành hai lần gọi cơ sở dữ liệu. Điều này đảm bảo thao tác đầu tiên hoàn thành trước khi thao tác thứ hai bắt đầu.

// Bước 1: Cập nhật trạng thái
await db.collection('tasks').updateOne({ _id: taskId }, { $set: { status: 'complete' } });

// Bước 2: Tăng bộ đếm hoàn thành
await db.collection('tasks').updateOne({ _id: taskId }, { $inc: { updateCount: 1 } });

Phương pháp 4: Tận dụng Update Pipelines (MongoDB 4.2+)

Các phiên bản MongoDB hiện đại cho phép bạn sử dụng một aggregation pipeline để cập nhật. Vì các pipeline xử lý các giai đoạn theo một trình tự nghiêm ngặt, bạn có thể thực hiện các chuyển đổi phức tạp mà bình thường sẽ gây ra xung đột.

db.products.updateOne(
  { _id: 505 },
  [
    { $set: { price: { $add: ["$price", 5.99] } } },
    { $set: { updatedAt: "$$NOW" } }
  ]
)

Kiểm tra giải pháp

Kiểm tra bản sửa lỗi của bạn trong mongosh. Một cập nhật thành công sẽ trả về phản hồi trong đó modifiedCount ít nhất là 1:

{
  acknowledged: true,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

Mẹo chuyên nghiệp để tránh xung đột trong tương lai

• Kiểm tra các Mongoose Hook: Nếu bạn sử dụng Mongoose, hãy kiểm tra các hook pre('update'). Các plugin như mongoose-timestamp thường chèn thêm một $set cho updatedAt, điều này có thể xung đột với các cập nhật thủ công của bạn.
• Làm phẳng các cập nhật: Ưu tiên sử dụng dot notation ("user.address.zip": 90210) thay vì các đối tượng lồng nhau. Nó làm giảm khả năng chồng chéo với các phần khác của tài liệu.
• Gỡ lỗi các đối tượng: Nếu bạn xây dựng các đối tượng cập nhật một cách linh hoạt, hãy log chúng ra trước khi chúng được gửi đến driver. Việc phát hiện một key bị trùng lặp trong log JSON sẽ dễ dàng hơn nhiều so với trong một tệp service dài 500 dòng.