已启用Server Members Intent时discord.NET GetUserAsync返回null解决方案

按以下优先级逐一排查问题即可：

• 首先核对代码端的网关意图配置，90%的同类问题都是只在开发者后台开启了Server Members Intent，但没有在机器人初始化代码中声明对应意图，也没有开启启动时全量用户拉取配置。正确的初始化参考代码如下：

var socketConfig = new DiscordSocketConfig
{
    // 必须显式声明GuildMembers意图，和后台开启的配置对应
    GatewayIntents = GatewayIntents.AllUnprivileged | GatewayIntents.GuildMembers,
    // 启动时自动拉取所有已加入服务器的全量成员列表到本地缓存
    AlwaysDownloadUsers = true
};
// 将上述config传入DiscordSocketClient构造函数完成初始化

配置修改后必须完全重启机器人进程才会生效。

• 核对意图配置的生效范围：
  1. 确认开发者后台开启Server Members Intent的应用，和你当前运行使用的Token对应的机器人是同一个，不要开错其他应用的配置，确认开启后点了页面底部的保存按钮
  2. 如果你的机器人加入的服务器总数超过100台，必须完成Discord的机器人验证流程，否则Privileged类的网关意图（包含Server Members Intent）会被强制禁用，即使后台手动开启也不生效
  3. 可以通过监听UserJoined事件做验证：如果新用户加入服务器时该事件完全不触发，就说明GuildMembers意图根本没有正常生效
• 排查调用时机问题：
  就算开启了AlwaysDownloadUsers配置，机器人启动后拉取全量成员列表需要一定时间，服务器规模越大耗时越长。不要在Ready事件触发后立刻调用GetUserAsync拉取非活跃用户，此时本地缓存还没加载完成。可以等待GuildMembersDownloaded事件触发对应服务器的成员加载完成后，再执行相关逻辑。
• 绕开缓存做接口可用性验证：
  不要依赖本地缓存，直接调用REST接口拉取用户，判断是缓存问题还是权限/ID问题，参考代码：

// 直接发起API请求拉取服务器成员，不经过本地缓存
var guildUser = await client.Rest.GetGuildUserAsync(guild.Id, userId);

如果上述方法依然返回null，逐一排查以下问题：

1. 传入的用户ID是正确的ulong格式数值，不要传带空格、特殊字符的字符串，也不要误传用户昵称、用户名作为ID
2. 目标用户确实是当前guild的成员，没有退出服务器、没有被封禁
3. 升级Discord.NET Nuget包到最新稳定版本，部分旧版本存在CacheMode.AllowDownload模式下不会正确发起API拉取请求的已知bug

• 排查参数认知误区：
  CacheMode.AllowDownload仅在本地缓存不存在目标用户时，才会尝试发起API请求拉取，如果你的代码没有配置GuildMembers意图，即使允许下载，Discord接口也不会返回完整的成员数据。

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