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

