学习JDA(Java Discord API)代码无报错但运行异常，如何排查修复？

从控制台报错和代码结构来看，运行异常的核心原因有3个：

1. 未显式声明JDA需要的Gateway Intent，JDA 4.2及以上版本强制要求声明所需的网关意图，未声明会直接导致连接失败
2. 未在Discord开发者后台开启特权网关意图（Privileged Gateway Intents），涉及成员、消息内容等敏感数据的意图需要手动开启，否则会被网关拒绝连接
3. 事件监听类未注册到JDA实例中，就算写了命令逻辑也无法触发执行

• 调整主类的JDA构建逻辑，显式声明你需要用到的意图，示例代码如下：

// 按需添加你需要的Intent，以下是常规消息、服务器相关功能需要的配置
JDA jda = JDABuilder.createDefault("你的机器人Token",
                GatewayIntent.GUILD_MESSAGES,
                GatewayIntent.GUILD_MEMBERS,
                GatewayIntent.MESSAGE_CONTENT
        )
        // 注册你的命令监听类，替换成你实际的类名
        .addEventListeners(new MyCommandListener())
        .build();
// 等待JDA完全加载完成再执行后续操作，避免空指针异常
jda.awaitReady();

• 进入Discord开发者平台的机器人管理页，找到「Privileged Gateway Intents」板块，开启Presence Intent、Server Members Intent、Message Content Intent三个开关
• 确认邀请机器人进入服务器时，勾选了bot和applications.commands两个授权范围，同时分配了发送消息、读取消息等必要权限
• 如果需要使用斜杠命令，需要额外在代码中注册全局/单服务器的命令定义，否则输入斜杠不会弹出对应命令选项

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