Discord.js报错TypeError [INVALID_TYPE]：参数非用户或角色求助

错误原因 #

报错明确指出permissionOverwrites.create的第一个参数不是合法的User或Role实例，问题根源是findRole变量没有获取到有效的Role对象，大概率返回了undefined、null或者非Role类型的值。

排查与解决步骤 #

1. 先校验角色获取结果的有效性 #

在调用权限覆写方法前，增加判断逻辑，避免传入非法参数：

let findRole = this.client.utils.findRole(message.guild, config.roles.support[i]);
// 校验角色是否存在且为合法Role实例
if (!findRole || !(findRole instanceof this.client.roles.Role)) {
  console.error(`无法匹配到目标角色：${config.roles.support[i]}`);
  return; // 根据业务场景做终止或降级处理
}
c.permissionOverwrites.create(findRole, {
    SEND_MESSAGES: true,
    VIEW_CHANNEL: true
});

2. 检查配置值与自定义工具方法 #

• 确认config.roles.support[i]的格式是否匹配findRole工具方法的要求：如果工具方法需要角色ID，检查配置里是否填了正确的Snowflake ID；如果需要角色名称，排查是否有拼写错误、大小写不一致的情况。
• 检查this.client.utils.findRole的实现逻辑，确保它返回的是discord.js标准的Role实例，而非字符串、普通对象等非标准值。

3. 替换为discord.js原生方法获取角色（更可靠） #

如果自定义工具方法存在逻辑漏洞，直接用discord.js原生API获取角色，避免自定义逻辑的误差：

// 按角色ID查找（推荐，ID唯一无冲突）
let findRole = message.guild.roles.cache.get(config.roles.support[i]);
// 或按角色名称查找（注意：名称可能重复，需确保目标名称唯一）
let findRole = message.guild.roles.cache.find(role => role.name === config.roles.support[i]);

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