You need to enable JavaScript to run this app. Discord.js如何实现新封禁成员的日志记录功能?
优惠活动
大模型
产品
解决方案
定价
更多

Discord.js如何实现新封禁成员的日志记录功能?

Discord封禁日志功能代码修复方案

现有代码问题

  • 未定义变量username:代码中嵌入字段使用了不存在的username变量,实际应使用事件回调传入的user对象的属性,未定义变量会触发运行时报错终止代码执行
  • 多余的await调用:client.channels.cache.get是同步方法,不需要加await,如果填写的频道ID有误、机器人无该频道访问权限,会拿到undefined导致后续发消息失败
  • 缺少必要的权限和意图配置:
    • 需在Discord开发者后台的机器人设置页开启Guilds、GuildModeration(旧版为Guild Bans)特权意图,否则无法接收guildBanAdd事件
    • 机器人需要拥有「查看审计日志」权限才能拉取封禁审计记录,需要拥有目标日志频道的「发送消息」「嵌入链接」权限才能正常发送日志
  • 缺少错误捕获逻辑:异步代码没有异常捕获,运行出错时无法定位问题
  • 占位符未替换:代码中获取频道的'ID'是占位符,需要替换为实际日志频道的数字ID

修复后代码(兼容Discord.js v12版本)

// 注意先确认已开启对应事件意图、机器人权限配置正确
client.on('guildBanAdd', async (guild, user) => {
  try {
    // 替换为你自己的日志频道数字ID
    const logChannel = client.channels.cache.get('替换为实际频道ID')
    // 校验频道是否存在、机器人有权限发消息
    if (!logChannel || !logChannel.permissionsFor(client.user).has(['SendMessages', 'EmbedLinks'])) {
      return console.log('日志频道不存在或无发送权限')
    }

    const fetchedLogs = await guild.fetchAuditLogs({
      limit: 1,
      type: 'MEMBER_BAN_ADD',
    });
    const banLog = fetchedLogs.entries.first();
    const executor = banLog ? banLog.executor : { tag: '未知操作员' }

    const embed = new Discord.MessageEmbed()
      .setTitle(`成员被封禁`)
      .setDescription(`所在服务器:${guild.name}`)
      .setColor("RED")
      .addField(`被封禁成员`, `${user.tag} (ID: ${user.id})`)
      .addField(`执行操作员`, `${executor.tag}`)
      .setTimestamp()

    await logChannel.send({ embeds: [embed] })
  } catch (err) {
    console.error('发送封禁日志出错:', err)
  }
});

版本适配说明

如果使用Discord.js v14及以上版本,将代码中的Discord.MessageEmbed替换为EmbedBuilder即可,其余逻辑通用。

内容的提问来源于stack exchange,提问作者user14425468

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 23:33:02