Mongoose执行save保存文档后select:false不生效解决方案

select: false 配置仅作用于Mongoose常规查询操作（find、findOne、findById等），对save()返回的文档实例不生效。save()返回的是内存中构造的完整文档对象，本身包含初始化传入的所有字段，不会自动应用查询层面的字段过滤规则，因此标记为select:false的字段会直接出现在返回结果中。

无需重新发起数据库查询，直接在Schema层配置JSON序列化规则，即可自动过滤所有标记为select:false的字段，一次配置全局生效：

• 定义Schema时添加toJSON转换钩子，在文档序列化为JSON的阶段自动剔除标记字段，整个过程仅操作内存中已有的文档数据，无任何额外数据库请求。
  完整配置示例：

import { Schema, model } from 'mongoose';

interface UserPreferences {
    departmentId: string;
    email: string;
    default: object;
}

const userPrefSchema = new Schema<UserPreferences>({
    departmentId: {type: String, required: true, select: false},
    email: {type: String, required: true, lowercase: true, select: false},
    default: {type: Object, required: false},
}, {
    toJSON: {
        transform(_doc, ret) {
            // 遍历Schema所有字段路径，自动移除select:false的字段
            for (const fieldPath of Object.keys(userPrefSchema.paths)) {
                if (userPrefSchema.paths[fieldPath].options.select === false) {
                    delete ret[fieldPath];
                }
            }
            return ret;
        }
    }
});

const SchemaModel = model<UserPreferences>('user-preferences', userPrefSchema);
export default SchemaModel;

配置完成后原有业务代码无需修改，res.send(await userPref.save())时Express会自动调用文档的toJSON方法完成过滤，后续新增select:false字段时也不需要手动维护过滤列表。

• 如果存在特殊场景需要返回敏感字段，可在transform逻辑中增加自定义判断规则，比如检测文档上的自定义标记位按需放开字段，灵活度很高。

不建议采用save后重新发起查询获取过滤后数据的方案，会产生不必要的数据库开销，序列化阶段过滤的性能远高于额外查询。

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