Discord.js音乐机器人切歌时出现UnhandledPromiseRejectionWarning及403错误问题

1. 权限缺失错误修复 #

报错栈指向GuildMember.edit调用触发权限不足，说明你切歌逻辑中包含修改用户/机器人自身状态的操作（比如修改播放状态昵称、调整语音频道权限等），需要按以下要求检查：

• 确认机器人角色已开启对应权限：如果是修改自身昵称，需要修改昵称权限；如果修改其他用户状态，需要管理成员权限，同时机器人角色层级要高于被编辑的目标用户角色
• 执行编辑操作前增加权限校验，无权限时跳过对应逻辑不要强行调用接口

2. EPIPE流错误修复 #

该错误是音频管道写入中断导致，切歌时没有先销毁上一首歌曲的音频流，直接推送新流就会触发管道断裂：

• 切歌逻辑执行前，先调用audioPlayer.stop()或者直接销毁当前活跃的音频流实例，释放资源后再加载新的歌曲流

3. 403封禁问题修复 #

你当前所有异步接口调用都没有加异常捕获，未处理的Promise rejection会导致请求异常重试，短时间内大量失败请求会触发Discord的反爬策略，返回403临时封禁：

• 所有异步操作（包括GuildMember.edit、音频加载、接口请求）都要套try/catch捕获异常，异常时直接终止当前操作不要重试
• 全局增加unhandledRejection监听，兜底捕获未处理的Promise异常，避免进程异常挂起

// 全局兜底异常捕获
process.on('unhandledRejection', (err) => {
  console.error('未捕获的Promise异常：', err);
});

// 切歌逻辑示例
async function skipSong(guild) {
  // 先停止当前播放流
  guild.audioPlayer.stop();
  
  // 权限校验
  if (!guild.me.permissions.has('MANAGE_NICKNAMES')) {
    // 无权限直接跳过状态修改
    return playNextSong(guild);
  }
  
  try {
    await guild.members.me.edit({ nick: `播放中：${nextSong.name}` });
    playNextSong(guild);
  } catch (err) {
    console.error('状态修改失败：', err);
    playNextSong(guild);
  }
}

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