如何在discord.js v13中从MongoDB移除自动角色字段值？

问题 #

我正在开发Discord机器人的自动角色系统，使用discord.js v13.8.0和Node.js v16。现有Guild模型包含autoRole1至autoRole5字段，想要实现remove-autorole命令来移除schema中指定的角色，但尝试使用data.unset方法无效，请问如何从MongoDB的schema中删除对应的字符串值？

模型代码 #

//Guild.js
const mongoose = require('mongoose');
const guildConfigSchema = mongoose.Schema({
  guildId: { type: String, match: /\d{18}/igm, required: true },
  autoRoleDisabled: {
    type: Boolean,
  },
  autoRole1: { type: String },
  autoRole2: { type: String },
  autoRole3: { type: String },
  autoRole4: { type: String },
  autoRole5: { type: String },
});
module.exports = mongoose.model('guild', guildConfigSchema);

尝试的命令代码（data.unset无效） #

const Welcome = require('../../models/Guild');
const enteredContent = args[0].toLowerCase();
if (!enteredContent) return message.channel.send('Please Specify a role! example: role2')
Welcome.findOne({ guildId: message.guild.id }, async (err, data) => {
    if (data) {
        if (data.autoRoleDisabled == false) {
            let role;
            if (enteredContent == 'role1') {
                role = data.autoRole1
                data.unset = { role: 1 }
            }
            if (enteredContent == 'role2') {
                role = data.autoRole2
                data.unset = { role: 1 }
            }
            if (enteredContent == 'role3') {
                role = data.autoRole3
                data.unset = { role: 1 }
            }
            if (enteredContent == 'role4') {
                role = data.autoRole4
                data.unset = { role: 1 }
            }
            if (enteredContent == 'role5') {
                role = data.autoRole5
                data.unset = { role: 1 }
            }
            if (!enteredContent == 'role1' || !enteredContent == 'role2' || !enteredContent == 'role3' || !enteredContent == 'role4' || !enteredContent == 'role5') { }
            try {
                role
            } catch (e) {
                return message.channel.send('There was an error adding this role to auto-role system. Please try again.');
            }
        } else return message.reply({ content: `<:no:990536144804524084> Auto-role is diabled!` })
        data.save();
    } else {
        return message.channel.send('Your auto-role is not setup');
    }
})

解决方案 #

你的代码存在两个核心问题导致data.unset无效：

• 错误使用unset：Mongoose中unset不是直接赋值给文档对象的属性，且你用字段值变量role作为键，根本没对应到schema里的autoRoleX字段。
• 冗余无效逻辑：try块没有实际执行代码，输入判断也存在逻辑错误。

正确实现方式 #

有两种可靠的方法可以移除指定字段的值：

方法1：直接设字段为undefined后保存

因为autoRoleX字段非必填，将其设为undefined后调用save()，Mongoose会自动从文档中移除该字段。

修改后的命令代码：

const Welcome = require('../../models/Guild');
const enteredContent = args[0]?.toLowerCase();

if (!enteredContent) {
    return message.channel.send('请指定要移除的角色！示例：role2');
}

// 映射输入到schema字段名
const fieldMap = {
    'role1': 'autoRole1',
    'role2': 'autoRole2',
    'role3': 'autoRole3',
    'role4': 'autoRole4',
    'role5': 'autoRole5'
};

const targetField = fieldMap[enteredContent];
if (!targetField) {
    return message.channel.send('无效的角色编号！请输入role1至role5中的一个');
}

Welcome.findOne({ guildId: message.guild.id }, async (err, data) => {
    if (err) {
        console.error(err);
        return message.channel.send('查询配置时出错，请重试');
    }
    if (!data) {
        return message.channel.send('自动角色系统尚未配置');
    }
    if (data.autoRoleDisabled) {
        return message.reply({ content: `<:no:990536144804524084> 自动角色功能已禁用！` });
    }

    // 移除指定字段的值
    data[targetField] = undefined;

    try {
        await data.save();
        return message.channel.send(`已成功移除${enteredContent}对应的自动角色`);
    } catch (e) {
        console.error(e);
        return message.channel.send('移除角色时出错，请重试');
    }
});

方法2：用updateOne配合$unset操作符

这种方式无需先查询文档，直接执行更新，效率更高：

const Welcome = require('../../models/Guild');
const enteredContent = args[0]?.toLowerCase();

if (!enteredContent) {
    return message.channel.send('请指定要移除的角色！示例：role2');
}

const fieldMap = {
    'role1': 'autoRole1',
    'role2': 'autoRole2',
    'role3': 'autoRole3',
    'role4': 'autoRole4',
    'role5': 'autoRole5'
};

const targetField = fieldMap[enteredContent];
if (!targetField) {
    return message.channel.send('无效的角色编号！请输入role1至role5中的一个');
}

try {
    const updateResult = await Welcome.updateOne(
        { guildId: message.guild.id, autoRoleDisabled: false },
        { $unset: { [targetField]: 1 } }
    );

    if (updateResult.matchedCount === 0) {
        return message.channel.send('自动角色系统未配置或已禁用');
    }
    if (updateResult.modifiedCount === 0) {
        return message.channel.send('该角色编号未设置自动角色');
    }
    return message.channel.send(`已成功移除${enteredContent}对应的自动角色`);
} catch (e) {
    console.error(e);
    return message.channel.send('移除角色时出错，请重试');
}

额外优化建议 #

• 给autoRoleDisabled设置默认值false，避免判断时出现undefined的情况。
• 考虑将autoRole1至autoRole5改为数组字段（如autoRoles: [String]），增删角色会更灵活，无需维护多个单独字段。

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