如何为Mongoose所有Schema全局实现自定义转换函数（避免重复编码）

当然可以！Mongoose 专门提供了Schema 插件机制来解决这种全局复用的问题，不用再每个 Schema 里重复写相同的转换逻辑啦。下面给你详细说怎么实现：

1. 编写全局复用的 Schema 插件 #

插件本质是一个函数，接收目标 schema 和可选配置参数，你可以在这个函数里统一添加全局方法（比如 toJSON）、钩子或者其他 Schema 配置。

假设你想要的 toJSON 逻辑是：移除 __v 字段、把 _id 转成字符串并改名为 id，还可以顺便加其他全局转换逻辑，插件代码可以这么写：

// 比如放在项目的 utils/mongooseGlobalPlugin.js 文件里
module.exports = function globalSchemaPlugin(schema) {
  // 全局配置 toJSON 转换规则
  schema.set('toJSON', {
    transform: function(doc, ret, options) {
      // 处理 _id 字段
      ret.id = ret._id.toString();
      delete ret._id;
      // 移除不需要的版本字段
      delete ret.__v;
      // 这里可以添加更多你需要的全局转换逻辑，比如格式化时间字段
      if (ret.createdAt) {
        ret.createdAt = ret.createdAt.toLocaleString();
      }
      return ret;
    }
  });

  // 还可以添加其他全局自定义方法，比如 toCustomObject
  schema.methods.toCustomObject = function() {
    const obj = this.toObject();
    // 自定义逻辑示例：添加全局统一的标识字段
    obj.globalFlag = 'from_global_plugin';
    delete obj.__v;
    return obj;
  };
};

2. 全局注册插件 #

在你初始化 Mongoose 的入口文件（比如 app.js 或 db/connect.js）里，引入插件并通过 mongoose.plugin() 全局注册——这样之后所有创建的 Schema 都会自动继承这些配置和方法：

const mongoose = require('mongoose');
const globalSchemaPlugin = require('./utils/mongooseGlobalPlugin');

// 全局注册插件，所有后续定义的 Schema 都会生效
mongoose.plugin(globalSchemaPlugin);

// 现在正常定义你的模型即可
const UserSchema = new mongoose.Schema({
  name: String,
  email: String,
  createdAt: { type: Date, default: Date.now }
});
const User = mongoose.model('User', UserSchema);

// 测试一下：模型实例自动拥有全局方法
const testUser = new User({ name: 'Test', email: 'test@example.com' });
console.log(testUser.toJSON()); 
// 输出会包含 id、name、email、格式化后的 createdAt，没有 _id 和 __v
console.log(testUser.toCustomObject());
// 输出会多一个 globalFlag 字段

3. 局部覆盖全局逻辑（可选） #

如果某个特定 Schema 需要特殊的转换规则，直接在该 Schema 里重新定义 toJSON 或其他方法即可，局部配置会自动覆盖全局的：

const SecretSchema = new mongoose.Schema({
  content: String,
  password: String
});

// 覆盖全局 toJSON，隐藏敏感字段
SecretSchema.set('toJSON', {
  transform: function(doc, ret, options) {
    ret.id = ret._id.toString();
    delete ret._id;
    delete ret.__v;
    delete ret.password; // 这个 Schema 要隐藏密码字段
    return ret;
  }
});

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