
本文详解如何在基于 discord.js v14 的基础机器人中,通过监听 messageCreate 事件实现关键词触发的自动回复,并提供可直接运行的代码示例、大小写处理技巧及关键注意事项。
本文详解如何在基于 discord.js v14 的基础机器人中,通过监听 `messagecreate` 事件实现关键词触发的自动回复,并提供可直接运行的代码示例、大小写处理技巧及关键注意事项。
要在 Discord 机器人中实现“用户发送‘Hai’,机器人自动回复‘Halo’”这类自动响应功能,核心在于正确监听并处理用户消息事件。Discord.js v14 已弃用旧版 message 事件, 必须使用 messageCreate 事件 ,且需确保已启用对应 Gateway Intent。
✅ 正确配置与实现步骤
首先,请确认你的 index.js 中已声明 GuildMessages 和 MessageContent 权限(后者用于读取消息文本):
const {Client, Events, GatewayIntentBits} = require('discord.js'); const {token} = require('./config.json'); const client = new Client({intents: [ GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, // ← 必须启用 GatewayIntentBits.MessageContent, // ← 若需匹配消息正文内容,必须启用(尤其在私信或受限频道)], });
⚠️ 注意:MessageContent intent 是敏感权限,上线前需在 Discord Developer Portal 的 Bot → Privileged Gateway Intents 中手动开启,并提交审核(若机器人面向未验证服务器)。
接着,在 client.on(‘ready’, …) 之后添加 messageCreate 监听器:
client.on('messageCreate', async (message) => {// 忽略机器人自身消息,防止自循环 if (message.author.bot) return; const content = message.content.trim(); // 简单关键词匹配(不区分大小写)if (/^hai$/i.test(content)) {await message.reply({ content: 'Halo!'}); } });
✅ 示例说明:
- /^hai$/i 是正则表达式:^ 表示开头,$ 表示结尾,i 表示忽略大小写 → 精确匹配独立单词“Hai”,避免误触“Bahai”或“Haiii”。
- 使用 await message.reply() 而非 message.channel.send(),以确保回复带引用(更符合 Discord 最佳实践)。
- async/await 保证异步操作安全(如后续扩展需调用 API)。
? 进阶建议(可选)
-
多关键词支持 :
const responses = {'^hai$': 'Halo!', '^apa kabar?$': 'Baik, terima kasih! ?', '^terima kasih$': 'Sama-sama!'}; for (const [pattern, reply] of Object.entries(responses)) {if (new RegExp(pattern, 'i').test(content)) {await message.reply({ content: reply}); break; } } -
防刷保护(简单限频):
可结合 Map 缓存用户最近响应时间,限制每 30 秒仅响应一次(防止被滥用)。
? 关键注意事项总结
- ❌ 不要遗漏 MessageContent intent(否则 message.content 恒为空字符串);
- ❌ 避免在 messageCreate 中处理 message.author.bot === true 的消息(否则可能引发无限回复);
- ✅ 始终对用户输入做 .trim() 处理,消除首尾空格干扰;
- ✅ 优先使用正则精确匹配(/^keyword$/i),比 includes() 更可靠;
- ✅ 生产环境务必添加错误处理(如 try/catch 包裹 message.reply())以应对权限不足等异常。
完成上述修改后,重启机器人即可生效。现在当用户在已授权的频道中发送 Hai(任意大小写),机器人将立即以引用形式回复 Halo! —— 简洁、稳定、符合 Discord v14 规范。






























