discord.js机器人无法对图片/媒体内容做出反应的问题排查求助

问题描述 #

开发了一个Discord机器人，预期会在所有#meme频道中对图片/媒体内容做出反应，但它并未对任何媒体内容产生反应。代码无报错，机器人启动正常且日志记录正常。

原代码 #

const { GatewayIntentBits } = require('discord.js');
const { Client } = require('discord.js');
const TOKEN = ""


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

client.on("ready", () => {
  console.log(`${client.user.tag} is online`);
});

client.on('messageCreate', (message) => {
  console.log(`message sent in ${message.channel.name}`);
  if (
    message.channel.name === 'memes' &&
    message.attachments.size > 0 &&
    message.attachments.some((attachment) => {
      const validExtensions = ['.mp4', '.gif', '.jpg', '.png', '.webm'];
      return validExtensions.some((ext) => attachment.url.endsWith(ext));
    })
  ) {
    message.react('⭐');
  }
});

client.login(TOKEN);

可能的问题及修复方案 #

• 频道名称匹配限制过严
  代码中仅匹配名称为memes的频道，但你需要处理所有#meme频道（比如名称为meme、memes-channel等变体）。
  修复：将频道判断逻辑改为模糊匹配或指定频道ID：

  // 模糊匹配包含meme的频道名称
  message.channel.name.toLowerCase().includes('meme')
  // 或指定多个目标频道ID
  ['频道ID1', '频道ID2'].includes(message.channel.id)
  

• 附件扩展名判断逻辑缺陷
  Discord部分附件URL可能带有参数（如?format=png），导致endsWith无法匹配到扩展名。
  修复：改用提取文件名后缀或检查contentType：

  // 方案1：提取文件名后缀
  message.attachments.some((attachment) => {
    const validExtensions = ['mp4', 'gif', 'jpg', 'png', 'webm'];
    const fileName = attachment.url.split('/').pop().split('?')[0];
    const ext = fileName.split('.').pop().toLowerCase();
    return validExtensions.includes(ext);
  })
  // 方案2：检查附件的contentType
  message.attachments.some(attachment => {
    const validTypes = ['image/jpeg', 'image/png', 'image/gif', 'video/mp4', 'video/webm'];
    return validTypes.includes(attachment.contentType);
  })
  

• 机器人权限不足
  机器人可能缺少在目标频道添加反应的权限，或者无法查看频道内容。
  修复：在服务器角色设置中，给机器人角色分配查看频道和添加反应权限，并确保该角色在目标频道生效。

• 未处理嵌入媒体内容
  如果用户是通过分享链接（而非直接上传）发送的媒体，这类内容会被归类为embeds而非attachments，原代码不会处理。
  修复：添加对嵌入媒体的判断：

  const hasValidMedia = 
    // 处理上传附件
    (message.attachments.size > 0 && /* 附件判断逻辑 */) ||
    // 处理嵌入的图片/视频
    message.embeds.some(embed => embed.image || embed.video);
  

• 日志验证消息接收
  先检查控制台输出的message sent in ${message.channel.name}是否包含目标meme频道的名称，确认机器人确实能接收到该频道的新消息。如果没有输出，需要检查机器人的频道权限或服务器邀请设置。

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