Mongoose+Node.js中toObject替换_id为id后客户端仍获_id问题

核心原因 #

你在Schema中仅配置了toObject选项，但Express的res.json()方法在序列化数据时，调用的是Mongoose文档的toJSON()方法，而非toObject()。这就导致你写的transform逻辑只在手动调用toObject()时生效（比如你console.log的场景），通过res.json返回客户端时不会触发，所以客户端收到的还是带_id的原始结构。

解决方案 #

方案1：同时配置toJSON选项

直接在Schema的配置中添加toJSON，让它和toObject使用相同的序列化规则：

const addressSchema = new mongoose.Schema({
    address: String,
    region: String,
    fullArea: Array,
},{
  timestamps: true,
  versionKey: false,
  toObject: {
      virtuals: true,
      getters: true,
      transform: (_, ret) => {            
          ret.id = ret._id;
          delete ret._id;
      }
  },
  // 新增toJSON配置，和toObject逻辑一致
  toJSON: {
      virtuals: true,
      getters: true,
      transform: (_, ret) => {            
          ret.id = ret._id;
          delete ret._id;
      }
  }
})

如果想避免代码重复，可以抽离配置对象复用：

const schemaSerializeOptions = {
  virtuals: true,
  getters: true,
  transform: (_, ret) => {            
      ret.id = ret._id;
      delete ret._id;
  }
};

const addressSchema = new mongoose.Schema({
    address: String,
    region: String,
    fullArea: Array,
},{
  timestamps: true,
  versionKey: false,
  toObject: schemaSerializeOptions,
  toJSON: schemaSerializeOptions
})

方案2：手动调用toObject()后返回

如果不想修改Schema，也可以在返回数据前手动转换文档：

// 单条文档场景
res.status(StatusCodes.OK).json(data.toObject());

// 多条文档（比如find返回的数组）场景
res.status(StatusCodes.OK).json(data.map(doc => doc.toObject()));

补充说明 #

Mongoose文档的toJSON和toObject是两个独立的序列化方法，默认行为存在差异。只有同时配置两者，才能覆盖手动转换、接口返回等所有序列化场景。

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