本文详解如何在基于 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 规范。
