使用discord.js与G4F开发Discord聊天机器人无响应问题排查

1. 事件监听错误：使用废弃的message事件 #

Discord.js v14及以上版本已废弃message事件，改用messageCreate事件监听消息。原代码里的client.on('message', ...)不会触发，机器人根本没在监听消息，自然不会响应。

修复：

client.on(Events.MessageCreate, async (message) => {
  // 原逻辑代码
});

2. 缺少必要的网关权限（Intents） #

当前代码只启用了GatewayIntentBits.Guilds，但要接收和处理消息，必须添加以下两个权限：

• GatewayIntentBits.GuildMessages：允许机器人接收服务器内的消息
• GatewayIntentBits.MessageContent：允许机器人读取消息内容（需在Discord开发者门户的机器人页面手动开启"Message Content Intent"开关）

修复后的客户端初始化代码：

const client = new Client({ 
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent
  ] 
});

3. 未排除机器人自身消息（防止循环） #

如果不判断消息是否来自机器人自己，可能导致机器人重复响应自身发送的消息，引发循环。建议添加判断：

if (message.author.bot) return;

4. G4F调用参数可能不完整 #

部分G4F版本的chatCompletion方法需要指定model参数，否则可能无法正常返回响应。可以完善调用：

const response = await g4f.chatCompletion({
  model: 'gpt-3.5-turbo',
  messages: messages
});

5. 错误处理覆盖不全 #

原代码只捕获了G4F调用的错误，但如果消息事件未触发、发送消息权限不足等情况，不会有日志输出。建议添加全局错误监听：

client.on('error', console.error);
client.on('warn', console.warn);

完整修复后的代码示例 #

const { Client, Events, GatewayIntentBits } = require('discord.js');
const token = 'Discord-Token';
const { G4F } = require('g4f');
const g4f = new G4F();

const client = new Client({ 
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent
  ] 
});

client.once(Events.ClientReady, readyClient => {
    console.log(`Successfully logged in as ${readyClient.user.tag}`);
});

client.on(Events.MessageCreate, async (message) => {
    if (message.author.bot) return; // 跳过机器人自身消息
    const userMessage = message.content;

    const messages = [
        { role: "user", content: userMessage }
    ];

    try {
        const response = await g4f.chatCompletion({
            model: 'gpt-3.5-turbo',
            messages: messages
        });
        console.log(response);
        await message.channel.send(response);
    } catch (error) {
        console.error("Error from g4f or Discord: ", error);
    }
});

// 全局错误监听
client.on('error', console.error);
client.on('warn', console.warn);

client.login(token);

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