使用Mongoose实现软删除失效问题排查

我一眼就看出问题所在了——你的ClientSchema里根本没定义active字段！这就是为什么你调用findByIdAndUpdate设置active: false完全没效果的原因。

为什么会这样？ #

Mongoose默认开启了「严格模式（strict mode）」，这个机制会严格按照Schema定义来校验和处理数据：如果你尝试更新一个Schema里不存在的字段，Mongoose会直接忽略这个更新操作，不会把它同步到MongoDB里。你能在then里拿到Client数据，是因为查询本身没问题，但更新的active字段被Mongoose过滤掉了，所以数据库里的文档自然不会变。

解决方法（推荐第一种） #

1. 给Schema添加active字段（最规范的做法）

既然要做软删除，active字段是核心，直接把它加到Schema里，还可以设置默认值为true（新创建的客户默认是活跃状态）：

export const ClientSchema = new Schema(
  {
    name: {
      type: String,
      trim: true,
      index: true,
      unique: true,
      required: true,
    },
    // 新增active字段，配置默认值和必填规则
    active: {
      type: Boolean,
      default: true,
      required: true
    }
  },
  { collection: 'clients' }
);

修改Schema后，别忘了给已有的历史数据补上active字段（不然旧数据会缺少这个字段），可以用批量更新操作：

// 执行一次这个命令，给所有没有active字段的文档设置为true
Client.updateMany({}, { $set: { active: true } })

2. 临时关闭严格模式（不推荐，仅应急用）

如果你暂时不想修改Schema，也可以在findByIdAndUpdate的选项里加上strict: false，绕过Mongoose的字段校验：

Client.findByIdAndUpdate(
  { _id: req.params.clientId },
  { active: false },
  { new: true, strict: false } // 关闭严格模式
)

但这种方法不推荐，因为会破坏Schema的契约性，容易导致数据结构混乱，后续维护会出问题。

验证修改 #

做完上面的操作后，再调用你的删除接口，就能看到active字段被成功设置为false了，软删除逻辑就能正常工作啦。

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