Discord.js 新指令角色校验失效出现roles.cache未定义错误

TypeError: Cannot read property 'filter' of undefined 本质是message.member.roles对象存在，但未初始化cache缓存结构，对应排查和修复方式如下：

• 未配置版本升级要求的特权网关意图
  执行npm update后大概率将discord.js升级到了v13及以上版本，该版本要求主动声明GuildMembers意图才能拉取完整的服务器成员角色数据。缺少该配置时，成员对象的角色管理器不会初始化缓存属性，直接表现为roles.cache为undefined。
  旧指令能正常运行，是因为旧指令的执行流程已经提前触发过角色数据拉取、完成了缓存初始化；新指令的触发路径没有经过这个前置流程，直接读取未初始化的缓存就会触发报错。
  修复需要完成两步配置：

1. 代码侧初始化Client时，在intents参数中补全Guilds、GuildMessages、GuildMembers三个必要意图
2. 登录Discord开发者后台，在机器人设置的特权意图板块，打开Server Members Intent开关，否则代码侧的配置不会生效

• 原有逻辑缺少空值兼容
  原代码直接链式读取多层嵌套属性，没有对中间层未初始化的情况做兜底，一旦某一层属性为undefined就会触发读取错误。可以将原有判断逻辑替换为带可选链兼容的写法，避免缓存未就绪时直接崩溃：

const hasCastawaysRole = message.member?.roles?.cache?.some(role => role.name === "Castaways")
if (hasCastawaysRole) {
  console.log("Works")
}

• 主动异步拉取成员数据绕开本地缓存问题
  如果配置完意图后依然偶发出现cache为undefined的情况，可以在执行判断前主动拉取该成员的最新完整数据，跳过本地缓存初始化流程：

// 拉取目标成员的完整服务器数据
const fullMember = await message.guild.members.fetch(message.author.id)
const hasCastawaysRole = fullMember.roles.cache.some(role => role.name === "Castaways")

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