使用Discord.js开发Discord机器人如何获取当前语音频道全部成员

DevOps 小满

2026-10-13

报错原因

你遇到的两个报错都是Discord.js v12及以上版本的API变动导致的：v12开始所有管理器挂载的集合数据都移到了.cache属性下，原来直接调用find、get的旧写法已经失效。

按ID找频道的正确写法：你原来的message.guild.channels.find(c => c.id === 频道ID) 改成 message.guild.channels.cache.get(频道ID)，按ID查找用get效率比find更高
按名称找频道的正确写法：你原来的client.channels.get("name", "频道名称")是v11的废弃写法，v12之后按属性查找统一用find，写法为client.channels.cache.find(c => c.name === '频道名称')

语音频道成员获取实现

前置准备

首先要在Discord开发者门户的机器人设置页，开启GuildVoiceStates、Guilds、GuildMembers三个特权网关意图，否则无法正常获取语音频道成员数据。

完整代码示例

// 从当前服务器获取指定ID的语音频道
const targetVoiceChannel = message.guild.channels.cache.get('替换为你的语音频道ID');

// 校验频道有效性：确认存在且是语音频道
if (!targetVoiceChannel || targetVoiceChannel.type !== 2) {
  return message.reply('未找到对应语音频道');
}

// 获取频道内的所有成员，返回Collection集合
const voiceMembers = targetVoiceChannel.members;

// 示例：遍历打印所有成员信息
voiceMembers.each(member => {
  console.log(`成员用户名：${member.user.tag}，成员ID：${member.id}`);
});

// 示例：提取所有成员ID的数组
const memberIdList = Array.from(voiceMembers.keys());