Mongoose：含null的ObjectID数组无法保存及填充的解决办法

这个问题我之前也碰到过——既要保留数组的索引位置，又不能让null破坏Mongoose的类型校验和填充逻辑，确实有点棘手。下面给你几个实用的解决方案，按优先级排序：

方法一：用无效ObjectId代替null（推荐，无需改Schema） #

MongoDB允许使用000000000000000000000000这个特殊的空ObjectId，它符合Schema.Types.ObjectId的类型要求，不会触发保存错误，同时能帮你占位保留索引。

具体操作： #

1. 删除元素时，把目标位置设为空ObjectId，而不是null：

const mongoose = require('mongoose');
// 定义空ObjectId常量
const EMPTY_STORY_ID = new mongoose.Types.ObjectId('000000000000000000000000');

// 替换目标索引的元素
const targetIndex = 1;
positions[targetIndex] = EMPTY_STORY_ID;

// 现在可以正常保存文档了
await yourDoc.save();

2. 填充后处理空值：
   填充时Mongoose会尝试用这个空ID查询Story集合，结果会是null，你可以在业务逻辑里过滤或替换成默认内容：

// 填充positions字段
const populatedDoc = await YourModel.findById(docId).populate('positions');

// 方案A：过滤掉空位置（如果不需要保留索引）
populatedDoc.positions = populatedDoc.positions.filter(story => story !== null);

// 方案B：保留索引，替换为默认值
populatedDoc.positions = populatedDoc.positions.map(story => 
  story || { _id: EMPTY_STORY_ID, title: 'Empty Position' }
);

方法二：改用对象数组存储（适合新项目） #

如果你的项目还处于初期，可以修改Schema，用对象数组来明确标记位置和关联ID，这样null就合法了：

const yourSchema = new mongoose.Schema({
  // 其他字段...
  positions: [{
    // 可选：存索引值，避免依赖数组下标
    positionIndex: Number,
    storyId: { 
      type: Schema.Types.ObjectId, 
      ref: 'Story', 
      default: null // 允许null
    }
  }]
});

这种方式的好处是结构更清晰，填充时只需要针对storyId字段：

const populatedDoc = await YourModel.findById(docId).populate('positions.storyId');

之后你可以直接遍历positions数组，判断每个对象的storyId是否为null即可。

方法三：保存前过滤null（不推荐，会丢失索引） #

如果你的业务不需要严格保留数组索引，只是想快速解决保存问题，可以给Schema加一个pre-save钩子，自动过滤掉null值：

yourSchema.pre('save', function(next) {
  // 过滤掉数组中的null和undefined
  this.positions = this.positions.filter(id => id != null);
  next();
});

⚠️ 注意：这个方法会改变数组长度，原来的索引位置会移位，只适合不需要保留位置信息的场景。

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