Discord JDA中getMutualGuilds()返回空列表问题求助

我正在开发一款Discord机器人，需求是当用户加入服务器时发送私信，并根据用户的私信回复为其分配角色。目前编写了onMessageReceived事件的处理代码，但即使用户与机器人处于同一服务器，调用user.getMutualGuilds()仍返回空列表。

相关代码 #

@Override
public void onMessageReceived(MessageReceivedEvent event) {

    String DmRecieved = event.getMessage().getContentRaw();

    User user = event.getAuthor();

    boolean isBot = user.isBot();

    boolean startsWithAU = DmRecieved.toUpperCase().startsWith("AU", 0);

    boolean messageTooLong = DmRecieved.length() > 8;

    if (event.getMessage().getContentRaw().isEmpty()) return;

    if (isBot) return;

    if (!startsWithAU ||  messageTooLong) {
        user.openPrivateChannel().queue((chanel1 ->
                chanel1.sendMessage("Not valid AU ID, please try again.").queue()));
    } else {

        List<Guild> guilds = user.getMutualGuilds();

        System.out.println(guilds);


    }

}

原因分析 #

getMutualGuilds()返回空列表通常是因为机器人缺少服务器成员特权，或者未正确配置数据缓存导致无法获取用户的服务器关联信息。

具体解决步骤 #

1. 开启特权网关意图
   登录Discord开发者门户，进入机器人设置页面，找到"Privileged Gateway Intents"，开启Server Members Intent和Message Content Intent——前者用于获取服务器成员数据，后者用于读取私信内容。

2. 初始化JDA时配置缓存与意图
   确保初始化JDA时启用了必要的缓存和网关意图，示例代码：

   JDA jda = JDABuilder.createDefault("你的机器人令牌")
       .enableIntents(GatewayIntent.GUILD_MEMBERS, GatewayIntent.MESSAGE_CONTENT)
       .setCacheFlags(CacheFlag.MEMBER_OVERRIDES, CacheFlag.USERNAME)
       .build();
   

3. 通过用户加入事件绑定服务器关联
   替代getMutualGuilds()的方案：在用户加入服务器时，直接记录用户ID与服务器ID的关联，后续处理私信时直接通过关联关系获取目标服务器，避免依赖缓存的互服列表。示例代码：

   // 存储用户与服务器的临时关联
   private static final Map<String, String> userToGuildMap = new HashMap<>();
   
   @Override
   public void onGuildMemberJoin(GuildMemberJoinEvent event) {
       User user = event.getUser();
       // 发送验证提示私信
       user.openPrivateChannel().queue(channel -> 
           channel.sendMessage("请发送你的AU ID完成验证").queue());
       // 记录用户与当前服务器的关联
       userToGuildMap.put(user.getId(), event.getGuild().getId());
   }
   
   // 在onMessageReceived中使用关联数据
   else {
       String targetGuildId = userToGuildMap.get(user.getId());
       if (targetGuildId != null) {
           Guild targetGuild = jda.getGuildById(targetGuildId);
           // 此处添加分配角色的逻辑
       }
   }
   

注意事项 #

• 机器人的邀请链接必须包含guilds.members.read权限，否则无法获取服务器成员数据。
• 缓存同步需要时间，避免在用户刚加入服务器时立即调用getMutualGuilds()，优先使用GuildMemberJoinEvent绑定关联更可靠。

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