Discord4J 中 getContent() 返回空字符串的解决方案

老敏君_9204

老敏君_9204

2026-08-14

413人浏览

原创

Discord4J 中 getContent() 返回空字符串的解决方案

Discord4J 3.2+ 版本中,Message.getContent() 默认返回空字符串,是因为 Discord 已将消息内容设为敏感权限项,必须在开发者门户显式启用“Message Content Intent”,并在 Bot 初始化时声明该意图,否则无法读取普通用户消息文本。

discord4j 3.2+ 版本中,getcontent() 默认返回空字符串,是因为 discord 已将消息内容设为敏感权限项,必须在开发者门户显式启用“message content intent”,并在 bot 初始化时声明该意图,否则无法读取普通用户消息文本。

在 Discord v10 API 更新后(2022 年起强制执行),普通用户发送的消息内容(即非 Bot 自身消息)默认不可访问——这是 Discord 的安全策略调整。即使你的代码逻辑完全正确(如示例中对 !todo 的过滤与响应),若未正确配置权限,eventMessage.getContent() 将始终返回空字符串(""),仅 Bot 自身发送的消息因上下文可追溯而能读取内容。

✅ 正确解决步骤

1. 启用 Developer Portal 中的 Message Content Intent

  • 登录 Discord Developer Portal → 选择你的应用 → Bot 标签页
  • 向下滚动至 Privileged Gateway Intents 区域
  • ✅ 勾选 MESSAGE CONTENT INTENT
  • 点击右上角 Save Changes

⚠️ 注意:若你的 Bot 所在服务器数量 ≥ 100 或面向公众,还需提交合规性审核,否则该 intent 在大型服务器中仍被禁用。

2. 在 Discord4J 初始化时显式声明 Intent

仅 Portal 开启不够,代码中也必须主动请求该 intent。使用 GatewayIntentSet 显式添加:

import discord4j.gateway.GatewayIntent;
import discord4j.gateway.intent.IntentSet;

// 构建 GatewayClientOptions(Spring Boot 配置示例)
@Bean
public DiscordClientBuilder discordClientBuilder() {
    return DiscordClientBuilder.usingToken("YOUR_BOT_TOKEN")
            .withGatewayIntents(IntentSet.all() // 或更安全的做法:
                    .or(IntentSet.builder()
                            .add(Intent.MESSAGE_CONTENT) // 关键:必须显式包含
                            .build()));
}

若使用 DiscordClient.create(...) 手动初始化(非 Spring),则:

DiscordClient client = DiscordClientBuilder.create("TOKEN")
        .gatewayResources(GatewayResources.builder()
                .intents(IntentSet.all().or(IntentSet.of(GatewayIntent.MESSAGE_CONTENT)))
                .build())
        .build();

3. 验证权限是否生效

修改 processCommand 方法,加入调试判断:

public Mono<void> processCommand(Message eventMessage) {
    String content = eventMessage.getContent();
    System.out.println("Raw content: '" + content + "' (length=" + content.length() + ")");
    System.out.println("Author bot? " + eventMessage.getAuthor().map(User::isBot).orElse(true));

    return Mono.just(eventMessage)
            .filter(message -> message.getAuthor().map(user -> !user.isBot()).orElse(false))
            .filter(message -> !message.getContent().isBlank() && message.getContent().equalsIgnoreCase("!todo")) // 防空检查
            .flatMap(Message::getChannel)
            .flatMap(channel -> channel.createMessage("Things to do today:\n" +
                    " - write a bot\n" +
                    " - eat lunch\n" +
                    " - play a game"))
            .then();
}</void>

✅ 正确配置后,控制台将输出类似:

Raw content: '!todo' (length=5)  
Author bot? false  

? 补充说明

  • Intent.MESSAGE_CONTENT 是特权 intent,需 Portal 开启 + 代码声明双重生效;
  • Spring Boot + Discord4J 3.2.5 环境下,若使用 discord4j-spring-boot-starter,请确保其版本 ≥ 1.0.0-M3(支持 intent 配置);
  • 不要依赖 eventMessage.getContent() 的非空性做业务逻辑,建议始终结合 !content.isBlank() 判断;
  • 若仍为空,请检查 Bot 是否已被重新邀请进服务器(启用新 intent 后需重新授权,URL 中需含 &permissions=... 参数)。

完成以上配置后,getContent() 即可正常获取用户消息文本,你的 !todo 命令也将如期触发响应。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11037

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8142

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7052

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1184

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

968

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1436

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2909

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20191

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1275

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.9万人学习