为什么Mongoose向子文档数组插入数据时末尾会出现null值？

• 子文档字段校验隐含转换：你定义的子文档要求4个字段均为String类型，如果推送的对象里某个字段是undefined，且Mongoose开启了默认配置strict: true，部分版本会把不符合结构的条目隐式转为null存入数组，而非直接丢弃。
• 数组操作残留问题：你当前操作的userCards.cards数组在之前的操作中可能存在未正确清理的空槽位，或者req.body.cards是类数组结构（比如从FormData转换得到的数组），存在不可见的undefined元素，push后存储时被序列化为null。
• Mongoose版本bug：部分旧版本Mongoose（<5.12.0）存在子文档数组push时末尾追加null的已知问题，是内部数组长度计算逻辑异常导致。

• 先清理现有异常数据，在保存前主动过滤数组中的无效值，代码修改参考如下：

exports.createCards = async (req, res, next) => {
  const userCards = await Cards.findById(req.user.cards);
  // 过滤原有数组的null、undefined值
  userCards.cards = userCards.cards.filter(item => item != null);
  // 过滤传入的无效元素后批量追加，无需循环
  const validCards = req.body.cards.filter(item => item && typeof item === 'object');
  userCards.cards.push(...validCards);
  const created = await userCards.save();
  console.log(created);
  res.status(201).json({
    status: "success",
  });
};

• 给Schema添加子文档必填校验，避免无效元素入库：

const cardsSchema = new mongoose.Schema({
  cards: [
    {
      front: { type: String, required: true },
      back: { type: String, required: true },
      nameOfSuperset: { type: String, required: true },
      nameOfSet: { type: String, required: true },
    },
  ],
});

• 如果是Mongoose版本问题，升级到5.12.0以上的稳定版本即可解决该底层bug。
• 可选优化：用$push操作符直接在数据库层面执行数组追加，避免本地操作文档带来的意外问题，属于原子操作也不会出现版本冲突导致的异常数据，写法参考如下：

exports.createCards = async (req, res, next) => {
  const validCards = req.body.cards.filter(item => item && typeof item === 'object');
  await Cards.findByIdAndUpdate(req.user.cards, {
    $push: { cards: { $each: validCards } }
  });
  res.status(201).json({
    status: "success",
  });
};

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