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.
相关产品推荐
相关产品推荐

