discord.js实现!mute禁言命令时guild未定义报错如何解决

• 直接报错触发点：你没有在当前作用域定义guild变量，调用guild.roles.create()时guild为undefined，因此抛出「无法读取undefined的roles属性」的类型错误。你前面查找已有角色使用的是message.guild，两者引用对象不一致。
• 隐藏逻辑错误1：创建角色时指定的名称为mute haha，但后续分配角色时查找的是名称为mute的角色，就算创建成功也无法匹配到对应角色。
• 隐藏逻辑错误2：创建角色是异步操作，未等待操作完成就执行后续查找、分配角色的逻辑，会出现角色还未写入服务器缓存就查找的空值问题。
• 隐藏兼容问题：discord.js v12及以上版本已经废弃member.addRole()方法，调用会触发警告或报错。

按如下逻辑修改代码即可：

1. 将guild.roles.create改为message.guild.roles.create，统一引用当前消息所属的服务器对象
2. 统一mute角色的命名，创建和查找时使用相同的名称
3. 用async/await处理异步操作，等待角色创建完成后再执行后续逻辑
4. 替换废弃的addRole方法为roles.add
5. 增加消息是否来自服务器的判断，避免私信场景下message.guild为undefined

修正后代码：

else if (message.content.startsWith(`${prefix}mute`)) {
    // 先判断是否为服务器消息，避免私信场景报错
    if (!message.guild) return message.channel.send('该指令只能在服务器中使用');
    // 先获取要禁言的用户
    const user = message.mentions.users.first();
    if (!user) return message.channel.send("你没有@要禁言的用户");
    
    const member = message.guild.members.resolve(user);
    if (!member) return message.channel.send("该用户不在当前服务器中");

    try {
        // 查找mute角色
        let muteRole = message.guild.roles.cache.find(x => x.name == 'mute');
        // 不存在则创建
        if (!muteRole) {
            muteRole = await message.guild.roles.create({
                name: 'mute',
                color: 'GRAY',
                reason: '自动创建禁言角色',
            });
        }
        // 分配角色
        await member.roles.add(muteRole);
        message.channel.send(`已禁言用户 ${user.tag}`);
    } catch (err) {
        console.error(err);
        message.channel.send('禁言操作失败，请检查机器人权限是否足够');
    }
}

注意：需要确保给机器人分配「管理角色」的权限，否则创建角色、分配角色的操作都会失败。

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