DiscordJS：如何刷新成员的角色缓存？

Discord.js的本地缓存不会自动实时同步所有外部（包括客户端手动操作或第三方API调用）的角色变更，默认的guild.members.fetch会优先使用缓存数据，这就是你遇到缓存始终不更新的原因。以下是几种可行的解决方案：

方案1：强制从API拉取最新成员数据 #

修改fetch调用，添加{ force: true }参数跳过缓存，直接从Discord API获取最新的成员角色状态，确保每次检查都是最新数据：

// 强制拉取最新成员数据，忽略本地缓存
let member = await guild.members.fetch({ user: user.discord_id, force: true });
// 用some替代find，仅判断角色是否存在，性能更优
if (member.roles.cache.some(role => role.id === roleId)) {
    continue;
}
let role = guild.roles.cache.find(role => role.id === roleId);
await member.roles.add(role);

方案2：监听角色变更事件同步缓存 #

在客户端实例上监听guildMemberUpdate事件，当Discord推送成员角色变更的通知时，Discord.js会自动更新对应成员的缓存，后续调用roles.cache就能拿到最新状态：

client.on('guildMemberUpdate', (oldMember, newMember) => {
    // 事件触发时，newMember的缓存已经是最新状态，无需额外操作
});

注意：该事件只能捕获Discord主动推送的变更，如果你是批量处理角色的场景，仍需结合方案1确保数据准确性。

方案3：手动更新缓存（仅适用于自有代码触发的变更） #

如果角色变更是由你的代码触发的，可以手动将角色加入成员的缓存中，避免后续检查使用旧数据，但这种方法无法覆盖客户端手动操作的场景：

let member = await guild.members.fetch(user.discord_id);
if (member.roles.cache.some(role => role.id === roleId)) {
    continue;
}
let role = guild.roles.cache.find(role => role.id === roleId);
await member.roles.add(role);
// 手动更新本地缓存
member.roles.cache.set(role.id, role);

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