Discord.js v14 默认禁用所有意图，若未显式启用 Guilds 和 GuildMessages 意图，即使机器人已上线且登录成功，也无法监听 messageCreate 事件——这是导致“消息无响应”的最常见原因。
discord.js v14 默认禁用所有意图，若未显式启用 `guilds` 和 `guildmessages` 意图，即使机器人已上线且登录成功，也无法监听 `messagecreate` 事件——这是导致“消息无响应”的最常见原因。
在 Discord.js v14+（当前主流版本）中，client.on('message') 已被完全移除，取而代之的是更安全、更细粒度的 messageCreate 事件，且必须通过 Intent 系统显式声明所需权限。你原始代码中仅启用了 "AutoModerationConfiguration" 意图，该意图仅用于自动审核配置变更，完全不涉及消息读取或发送能力，因此 bot 虽然能登录（触发 ready），却对任何用户消息“视而不见”。
✅ 正确做法如下：
-
启用必要意图：
Guilds（访问服务器基础信息）和GuildMessages（接收非私信频道中的消息）是监听普通消息的最低要求； -
使用
messageCreate事件（而非已废弃的message）； -
确保 Bot 在 Discord 开发者门户中已开启对应 Privileged Intent（
MESSAGE_CONTENT在某些场景下还需额外启用，见下文说明）。
✅ 修正后的完整示例代码
const { Client, GatewayIntentBits } = require('discord.js');
// 正确声明意图：GUILDS + GUILD_MESSAGES 是接收消息的必需项
const client = new Client({
intents: [
GatewayIntentBits.Guilds,
GatewayIntentBits.GuildMessages,
// ⚠️ 注意：若需读取消息内容（如 msg.content === 'ping'），还需启用以下意图
GatewayIntentBits.MessageContent // ← v14.11+ 推荐启用（尤其当 bot 需解析文本内容时）
]
});
client.once('ready', () => {
console.log(`✅ Logged in as ${client.user.tag}!`);
});
// 使用 messageCreate 替代已废弃的 'message' 事件
client.on('messageCreate', (msg) => {
// 过滤掉机器人自身消息，避免自触发
if (msg.author.bot) return;
console.log(`? [${msg.guild?.name || 'DM'}] ${msg.author.tag}: ${msg.content}`);
if (msg.content === 'ping') {
msg.reply('Pong! ?').catch(console.error);
}
});
client.login('YOUR_BOT_TOKEN_HERE'); // 替换为真实 Token? 关键注意事项
-
开发者门户同步设置：登录 Discord Developer Portal → 选择你的应用 → Bot → Privileged Gateway Intents → 启用
Message Content Intent（若代码中使用了msg.content、msg.mentions等字段）。未启用将导致msg.content为空字符串（即使意图已传入客户端）。 -
权限范围限制：
GuildMessages仅允许接收文本频道中的消息；若需监听私信（DM），需额外添加DirectMessages意图（但 DM 消息默认不触发messageCreate，除非 bot 是消息接收方且已启用相应 intent）。 -
避免拼写错误：
GatewayIntentBits.GuildMessages不可写作GUILD_MESSAGES字符串（v14 使用枚举常量，字符串形式仅兼容旧版迁移层，不推荐）。 -
调试建议：可在
messageCreate回调开头添加console.log(msg)查看完整对象结构，确认是否收到事件；同时检查控制台是否有Missing Access或Invalid Intent类型警告。
遵循以上配置后，bot 即可稳定接收并响应频道内消息。记住：意图 ≠ 权限（Permissions），它是 WebSocket 数据流的“白名单”，而服务器权限（如“View Channel”、“Read Message History”）需在 Discord 服务端为 bot 角色手动赋予——二者缺一不可。
