You need to enable JavaScript to run this app. Discord音乐Bot执行cm!play触发UnhandledPromiseRejectionWarning报错求助
优惠活动
大模型
产品
解决方案
定价
更多

Discord音乐Bot执行cm!play触发UnhandledPromiseRejectionWarning报错求助

报错根因定位与修复方案

报错本质拆解

  • send EPERM 5.200.14.147:50004:UDP套接字发送数据包时被系统/防火墙拦截,属于网络层权限拒绝,这是触发后续所有语音连接超时问题的核心根源
  • VOICE_CONNECTION_TIMEOUT:语音握手超时,因为被拦截的UDP流量无法和Discord语音节点完成双向通信,15秒内未通过认证导致连接失败
  • 已添加的.catch()未生效的原因:你写的捕获逻辑仅覆盖了channel.join()这一个Promise分支,没有覆盖底层UDP套接字异常、语音连接内部超时、其他命令分支下的所有未捕获Promise,异常完全绕开了你的捕获逻辑

代码层面修复点

  • 补全所有缺失的前置校验与异常捕获:
    • 调用channel.join()前必须判断触发命令的用户是否真的在语音频道内,否则voice.channel为null会直接触发空值报错
    • 检查Bot自身对目标语音频道的连接、发言权限,权限不足时提前给出提示,不要直接触发连接逻辑
    • 所有返回Promise的discord.js方法(包括message.delete()、message.channel.send()、guild.fetchInvites()、connection.play())都要补全异常捕获,避免权限不足、操作失败时触发未捕获异常
  • 修复后的cm!play命令参考实现:
if (command === 'play') {
  if (!message.member.hasPermission("MANAGE_CHANNELS")) return;
  // 前置校验:用户是否在语音频道
  if (!message.member.voice.channel) {
    return message.reply('你需要先加入语音频道才能使用播放命令');
  }
  const targetVoiceChannel = message.member.voice.channel;
  // 前置校验:Bot的频道权限
  if (!targetVoiceChannel.permissionsFor(message.guild.me).has(['CONNECT', 'SPEAK'])) {
    return message.reply('我没有该语音频道的连接与发言权限');
  }
  targetVoiceChannel.join()
    .then(connection => {
      const audioDispatcher = connection.play('https://eu1.fastcast4u.com/proxy/chillmusik?mp=/1.mp3');
      audioDispatcher.on('error', err => console.log('音频播放异常:', err));
      console.log('已成功连接语音频道');
    })
    .catch(err => {
      console.error('语音连接失败:', err);
      message.reply('语音连接失败,请检查网络与权限配置');
    });
}

网络层面修复点

  • EPERM UDP错误不属于代码逻辑问题,必须在运行Bot的服务器环境排查:
    • 检查云服务商安全组、主机本地防火墙的出站规则,放行Discord语音节点通信需要的UDP端口范围(通常为50000-65535)
    • 如果是在共享受限主机环境部署,需要联系主机服务商开放对应的UDP出站权限,否则无论怎么修改代码,都无法完成语音连接握手

全局兜底配置

在代码入口位置添加全局未捕获异常监听,避免遗漏的异常直接导致进程崩溃:

process.on('unhandledRejection', err => {
  console.error('捕获到未处理的Promise异常:', err);
});

内容的提问来源于stack exchange,提问作者Matteo B.

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.10 08:54:07