MongoDB删除文档数组内嵌套产品文档失败问题排查

我在MongoDB的商店文档中维护了一个products数组，数组元素是包含product嵌套对象的文档，product对象内有productId字段。尝试通过storeId定位目标商店，使用updateOne结合$pull操作删除指定productId的产品，但执行后返回结果显示matchedCount为1，modifiedCount为0，未成功删除目标产品。

相关代码 #

async deleteOneStoreProduct(storeId: string, productId: string) {
    console.log(storeId, productId);
    const storetofind = await this.storeModel.findOne({
      storeId,
    });
    if (!storetofind) {
      throw new Error('Store not found');
    }

    const store = await this.storeModel.updateOne(
      {
        storeId,
      },
      {
        $pull: {
          products: { 'product.productId': productId },
        },
      },
    );
    return store;
    // 以下代码因提前return不会执行
    // const store = await this.storeModel.updateOne(
    //   {
    //     storeId: storeId,
    //   },
    //   {
    //     $pull: { products: { 'product.productId': productId } },
    //   },
    // );
    console.log(store);
    if (!store) {
      throw new Error('Store not found');
    }
    return store;
  }

文档结构示例 #

{
  "_id":"656b0bb194d0010639157793",
  "storeName":"Muzardemoses Tech",
  "storeId":"Muzardemoses Tech_198",
  "isProfileVerified":"false",
  "isProfileCompleted":"true",
  "companyPhone":"09134452294",
  "storeAddress":"77, Oremeji Street , off EKoro junction, opp NNPC Abule-Egba",
  "storeDescription":"Buy Your gadget at affordable price",
  "storeLogo":"https://res.cloudinary.com/fundrit-files/image/upload/v1701514159/bnpl/…",
  "storeCategory":[],
  "storeState":"Lagos",
  "storeLGA":"Alimosho",
  "storeEmail":"richardebrain21@gmail.com",
  "storeWebsite":"https://richardadebayo.tech",
  "__v":0,
  "products":[
    {
      "storeId": "Muzardemoses Tech_198",
      "companyPhone": "09131449283",
      "storeAddress": "77, Oremeji Street , off EKoro junction, opp NNPC Abule-Egba",
      "storeName": "Muzardemoses Tech",
      "storeLogo": "https://res.cloudinary.com/fundrit-files/image/upload/v1701514159/bnpl/jgklrlhfamxrzxlj13td.jpg",
      "product": {
          "productName": "Macbookpro 2017",
          "productDescription": "MacBook Pro (13-inch, 2017, Two Thunderbolt 3 ports)",
          "productPrice": "1500000",
          "productCategory": "Laptops",
          "productCondition": "New",
          "features": "",
          "productBrand": "Apple",
          "productImages": [
              "https://res.cloudinary.com/fundrit-files/image/upload/v1701784329/bnpl/lm8j5caswk9la2kjterh.jpg",
              "https://res.cloudinary.com/fundrit-files/image/upload/v1701784330/bnpl/rkgoawk1dkc3hqtvtlgh.jpg",
              "https://res.cloudinary.com/fundrit-files/image/upload/v1701784330/bnpl/nlbuyqvakofe8yqp7rrd.jpg",
              "https://res.cloudinary.com/fundrit-files/image/upload/v1701784331/bnpl/thkfyndqklp6en0phfuz.jpg"
          ],
          "productId": "Macbookpro_2017_1701784331869",
          "createdAt": "2023-12-05T13:52:11.869Z"
      }
    },
    {}
  ]
}

执行响应 #

{
    "acknowledged": true,
    "modifiedCount": 0,
    "upsertedId": null,
    "upsertedCount": 0,
    "matchedCount": 1
}

注：storeId可正常定位到目标商店。

问题原因分析 #

出现matchedCount=1但modifiedCount=0的情况，说明MongoDB找到了目标商店，但未找到符合$pull条件的数组元素，常见原因包括：

• 传入的productId与数据库中的值不匹配：比如存在大小写差异、多余空格、字符拼写错误，导致无法匹配到对应产品。
• 数据类型不匹配：如果数据库中product.productId是数字类型，而代码传入的是字符串类型（或反之），会导致匹配失败。
• 数组中无符合条件的元素：虽然你认为目标产品存在，但实际该商店的products数组中没有product.productId等于指定值的元素。
• 代码提前return导致后续验证缺失：当前代码在执行updateOne后直接return，无法排查是否真的存在目标产品。

解决方案 #

1. 优化代码，先验证产品存在性

在执行updateOne前，先查询目标商店是否包含指定产品，避免无效操作：

async deleteOneStoreProduct(storeId: string, productId: string) {
  console.log('Target store:', storeId, 'Target productId:', productId);
  
  // 检查商店存在且包含目标产品
  const targetStore = await this.storeModel.findOne({
    storeId,
    'products.product.productId': productId
  });

  if (!targetStore) {
    throw new Error('商店不存在或目标产品不在该商店中');
  }

  // 执行删除操作
  const result = await this.storeModel.updateOne(
    { storeId },
    { $pull: { products: { 'product.productId': productId } } }
  );

  if (result.modifiedCount === 0) {
    throw new Error('删除失败，未找到匹配的产品');
  }

  return result;
}

2. 核对productId的准确性

打印查询到的商店的products数组，对比传入的productId与数据库中的值是否完全一致：

console.log('Store products IDs:', targetStore.products.map(item => item.product?.productId));

3. 确认数据类型匹配

检查Mongoose Schema中product.productId的类型定义，确保与传入参数的类型一致（比如都是String类型）：

// 示例Schema定义
const ProductSchema = new Schema({
  productId: { type: String, required: true },
  // 其他产品字段...
});

const StoreSchema = new Schema({
  storeId: { type: String, required: true },
  products: [
    new Schema({
      storeId: String,
      // 其他字段...
      product: ProductSchema
    })
  ],
  // 其他商店字段...
});

内容的提问来源于stack exchange，提问作者Richardebrain