discord.js通过角色名获取role对象报错undefined 移除角色类型错误

你遇到的INVALID_TYPE报错，是因为你传给member.roles.remove()方法的role参数为undefined。该方法仅支持传入角色对象、角色ID（Snowflake）、或由前两者组成的数组/Collection，不接受undefined类型的入参，因此触发类型校验错误。

• 你的discord.js版本升级到v13及以上后，未开启必要的网关意图，导致服务器角色没有全量缓存到本地，find方法匹配不到对应角色
• 角色名包含空格时，你直接取args[1]仅能拿到空格前的第一个片段，和实际角色名无法匹配
• 你使用===做严格匹配，如果用户输入的角色名大小写和实际角色名不一致，也会匹配失败
• 目标角色已经被服务器管理员删除

第一步：先添加非空校验，避免无效传参 #

let role = message.guild.roles.cache.find(role => role.name === args[1]);                
const member = message.mentions.members.first();

// 新增基础校验逻辑
if (!member) return message.reply('未识别到你指定的目标成员');
if (!role) return message.reply(`未找到名称为「${args[1]}」的服务器角色`);

member.roles.remove(role).catch((e) => console.log(e));

第二步：修复角色匹配逻辑 #

处理缓存不全问题 #

如果是v13及以上版本，先确认初始化客户端时已经开启了必要的网关意图：

const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds, // 必须开启，用于获取服务器相关数据
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent, // 必须开启，用于读取消息内容解析args
    GatewayIntentBits.GuildMembers
  ]
});

如果开启意图后仍无法匹配到角色，可以直接调用接口拉取全量服务器角色，不走本地缓存：

const allRoles = await message.guild.roles.fetch();
let role = allRoles.find(role => role.name === args[1]);

处理空格和大小写匹配问题 #

如果你的服务器允许角色名包含空格，可以将args从索引1开始的所有内容拼接为完整角色名，同时转成小写做非严格匹配：

const targetRoleName = args.slice(1).join(' ').toLowerCase();
let role = message.guild.roles.cache.find(role => role.name.toLowerCase() === targetRoleName);

第三步：权限校验 #

确认机器人的角色在服务器角色列表中的排序高于你要操作的目标角色，且机器人已经被授予管理角色权限，否则即使找到对应角色也无法执行移除操作。

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