如何使用Mongoose实现看板卡片的跨列表/同列表位置迁移？

问题 #

在Node.js项目中使用Mongoose，数据库集合的数据结构为包含多个列表的数组，每个列表拥有独立的cards数组，前端以看板形式展示，支持两种操作：

• 同一列表内调整卡片位置（如从位置3移到0）
• 将卡片从一个列表移至另一个列表的指定位置（如从列表A移到列表B的位置4），原列表不再保留该卡片（类似Trello功能）

当前方案是全量查询文档、深拷贝修改leadsList后再保存，但列表数据量可达数千条，频繁操作性能开销极大，希望直接在数据库层面完成操作，无需处理整个文档。

当前实现代码：

async moveCard(req, res) {
    const { flowID } = req.params;
    const { from, to, fromList, toList } = req.body;

    try {

      const leadsCollection = await Lead.findOne({ flowID });

      if (!leadsCollection) {
        return res.status(404).json({ message: "Erro ao buscar usuário." });
      }
    
      const updatedLeadsList = JSON.parse(JSON.stringify(leadsCollection.leadsList));
      const cardToMove = updatedLeadsList[fromList].cards.splice(from, 1)[0];
      updatedLeadsList[toList].cards.splice(to, 0, cardToMove);
    
      const result = await Lead.findOneAndUpdate(
        { flowID },
        { $set: { leadsList: updatedLeadsList } },
        { new: true }
      );
    
      if (!result) {
        return res.status(404).json({ message: "Erro ao buscar usuário." });
      }

      return res.status(200).json({ message: "Card movido com sucesso."});
    } catch (error) {
      res.status(500).json({ message: "Erro ao mover card." });
    }
  }

数据结构示例（移动后）：

const leadsList = [
  {
    listID: "A",
    cards: [
      {
        id: "card-2",
        createdAt: "",
        variables: []
      }
    ]
  },
  {
    listID: "B",
    cards: [
      {
        id: "card-3",
        createdAt: "",
        variables: []
      },
      {
        id: "card-4",
        createdAt: "",
        variables: []
      },
      {
        id: "card-1",
        createdAt: "",
        variables: []
      }
    ]
  },
]

最优解决方案 #

利用MongoDB的原子数组操作符，直接在数据库层面完成修改，无需拉取整个文档。需要区分同列表移动和跨列表移动两种场景：

1. 核心实现代码 #

async moveCard(req, res) {
  const { flowID } = req.params;
  // 建议传入cardId替代索引，避免并发操作导致的索引偏移问题
  const { from, to, fromList, toList, cardId } = req.body;

  try {
    // 仅查询需要移动的卡片数据，而非整个文档
    const leadDoc = await Lead.findOne(
      { flowID },
      { [`leadsList.${fromList}.cards`]: { $elemMatch: { id: cardId } } }
    );

    if (!leadDoc || !leadDoc.leadsList[fromList]?.cards.length) {
      return res.status(404).json({ message: "文档或卡片不存在" });
    }
    const cardToMove = leadDoc.leadsList[fromList].cards[0];

    let updateOps = {};
    if (fromList !== toList) {
      // 跨列表操作：原子移除+插入
      updateOps = {
        // 从原列表移除目标卡片
        $pull: { [`leadsList.${fromList}.cards`]: { id: cardId } },
        // 插入到目标列表的指定位置
        $push: {
          [`leadsList.${toList}.cards`]: {
            $each: [cardToMove],
            $position: to
          }
        }
      };
    } else {
      // 同列表操作：先移除再插入到新位置，保证原子性
      updateOps = [
        { $pull: { [`leadsList.${fromList}.cards`]: { id: cardId } } },
        {
          $push: {
            [`leadsList.${toList}.cards`]: {
              $each: [cardToMove],
              $position: to
            }
          }
        }
      ];
    }

    const result = await Lead.findOneAndUpdate(
      { flowID },
      updateOps,
      { new: true, runValidators: true }
    );

    if (!result) {
      return res.status(404).json({ message: "卡片移动失败" });
    }

    return res.status(200).json({ message: "卡片移动成功", data: result });
  } catch (error) {
    console.error(error);
    return res.status(500).json({ message: "移动卡片时出错" });
  }
}

2. 关键优化点 #

• 原子操作保证一致性：$pull和$push都是MongoDB原子操作，避免并发操作导致的数据错乱问题
• 最小化数据传输：仅查询目标卡片，而非整个文档，大幅降低内存和网络开销
• 用ID替代索引定位：直接通过卡片唯一ID定位，避免因并发修改导致的索引偏移风险
• 索引优化：给leadsList.listID和leadsList.cards.id添加索引，提升查询和修改效率

3. 推荐的Schema结构 #

为了更高效地执行操作，建议给列表和卡片添加唯一标识并创建索引：

const cardSchema = new mongoose.Schema({
  id: { type: String, required: true, unique: true },
  createdAt: Date,
  variables: []
});

const listSchema = new mongoose.Schema({
  listID: { type: String, required: true, unique: true },
  cards: [cardSchema]
});

const leadSchema = new mongoose.Schema({
  flowID: { type: String, required: true, unique: true },
  leadsList: [listSchema]
});

// 添加索引优化查询性能
leadSchema.index({ "leadsList.listID": 1 });
leadSchema.index({ "leadsList.cards.id": 1 });

const Lead = mongoose.model('Lead', leadSchema);

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