Mongoose模型更新后创建用户失败：macAddress约束残留

我正在开发一款应用，尝试更新User模型：移除了原带唯一约束的macAddress字段，替换为uuid字段。但现在创建用户（已有用户存在时）始终报错：

{
    "macAddress": "The macAddress \"null\" is already taken."
}

该错误由我基于Mongoose错误编写的工具函数格式化而来，说明Mongoose仍认为模型存在macAddress属性。此前保留macAddress时也曾出现该错误但未在意，现在无法忽略，且尝试调用user.save()时提示该方法不存在。我已清空数据库但问题依旧，寻求如何更新Mongoose模型适配新Schema（用UUID替代MAC）的解决方案。

User模型 #

const { Schema, model, models } = require("mongoose");

const userSchema = new Schema(
    {
        uuid: {
            type: String,
            required: [true, "UUID is required."],
            match: [
                // 12 characters long, 4 groups of 3 characters separated by hyphens
                /^[0-9a-f]{3}-[0-9a-f]{3}-[0-9a-f]{3}-[0-9a-f]{3}$/i,
                '"{VALUE}" is not a valid UUID.',
            ],
        },
        username: {
            type: String,
            required: [true, "Username is required."],
            unique: [true, 'The username "{VALUE}" is already taken.'],
            trim: true,
        },
        email: {
            type: String,
            required: [true, "Email is required"],
            unique: [true, 'The email "{VALUE}" is already taken.'],
            match: [
                /^[A-Za-z0-9_\.]+@[A-Za-z]+\.[A-Za-z]{2,3}$/,
                '"{VALUE}" is not a valid email.',
            ],
        },
        password: {
            type: String,
            required: [true, "Password is required."],
        },
        _tags: {
            type: [
                {
                    type: Schema.Types.ObjectId,
                    ref: "Tag",
                },
            ],
            default: [],
        },
        _token: {
            type: String,
        },
    },
    { timestamps: true, versionKey: false }
);

// before it was `const userModel = models["User"] || model("User", userSchema);`
const userModel = model("User", userSchema);

module.exports = userModel;

注册路由 #

router.post("/register", async (req, res) => {
    try {
        const { uuid, username, email, password } = req.body;

        if (!(uuid && username && email && password)) {
            return res
                .status(400)
                .json({ message: "Please fullfil all fields." });
        }

        // Make Sure The UUID Is Unique
        let userWithSameUUID = (await getUsers({ uuid })).users[0];

        if (userWithSameUUID)
            return res.status(409).json({
                message: "This UUID is already registered.",
            });

        let encryptedPassword = await bcrypt.hash(password, 10);

        let user = await createUser({
            uuid,
            username,
            email: email.toLowerCase(),
            password: encryptedPassword,
        });

        // Check For Validation Errors
        if (user.err) {
            let { err } = user;
            let duplicateErrCodes = [11000, 11001];

            if (duplicateErrCodes.includes(err.code)) {
                return res.status(409).json(formatDuplicateError(err));
            }

            return res.status(400).json(formatValidationError(err));
        }

        user._token = jwt.sign(
            {
                _id: user._id,
                username: user.username,
                uuid: user.uuid,
            },
            process.env.TOKEN_KEY
        );

        await user.save();

        res.status(201).json({
            user: { ...user.toJSON(), password: undefined },
        });
    } catch (err) {
        res.status(500).json({ message: err.message });
    }
});

createUser函数 #

async function createUser(user) {
    try {
        const newUser = await new User(user).save();

        return newUser;
    } catch (err) {
        return { err };
    }
}

1. 删除MongoDB中遗留的macAddress索引 #

清空数据库不会自动删除集合的索引，原macAddress字段的唯一索引仍存在。当插入新文档时，MongoDB会自动为不存在的字段填充null，触发唯一约束校验。

手动通过MongoDB Shell清理索引：

# 进入MongoDB命令行
mongosh
# 切换到你的应用数据库
use your_database_name
# 查看User集合的所有索引
db.users.getIndexes()
# 删除macAddress相关的唯一索引（替换为实际索引名，通常是macAddress_1）
db.users.dropIndex("macAddress_1")

2. 恢复模型的单例加载逻辑 #

你修改了模型加载代码，从models["User"] || model("User", userSchema)改成直接调用model("User", userSchema)，这会导致每次请求都重新编译模型，引发上下文冲突，甚至丢失Mongoose文档的save()方法。改回单例模式：

const userModel = models.User || model("User", userSchema);

3. 重启服务并验证 #

修改模型和索引后，必须重启Node.js服务，确保Mongoose加载最新的Schema定义。重启后测试用户创建流程，确认错误是否消失。

4. 排查save()方法丢失问题 #

如果仍提示save()不存在，检查createUser的返回值是否为Mongoose文档实例：

// 在createUser调用后添加
console.log(user instanceof User); // 正常应输出true

若输出false，说明user被转换成了普通JS对象，需排查getUsers或其他数据处理环节是否存在不必要的转换操作。

内容的提问来源于stack exchange，提问作者shestakov-dev