使用discord.js获取语音频道失败：移动用户至私人频道报错排查

问题排查与修复步骤： #

1. 检查频道名称完全匹配
   确保服务器内的语音频道名称和代码中的'Private Channel'完全一致，包括大小写、空格、特殊字符。比如实际频道名是“private channel”（全小写），代码里的大写开头会直接导致匹配失败。

2. 修正频道类型判断（适配Discord.js版本）
   不同版本的Discord.js使用不同的频道类型常量：

• Discord.js v13及更早版本：'GUILD_VOICE'是正确类型值
• Discord.js v14+：需要使用ChannelType.GuildVoice，先导入类型：

  const { ChannelType } = require('discord.js');
  

  再修改查找逻辑：

  const channel = interaction.guild.channels.cache.find(
    (c) => c.type === ChannelType.GuildVoice && c.name === 'Private Channel'
  );
  

3. 改用更可靠的频道获取方式
   缓存可能未加载全部频道，建议用以下两种方式替代缓存查找：

• 按名称主动获取：

  const channel = await interaction.guild.channels.fetch({ 
    name: 'Private Channel', 
    type: ChannelType.GuildVoice
  }).catch(() => null);
  

• 按频道ID获取（推荐，彻底避免名称冲突）：

  // 替换为你的私人语音频道ID
  const PRIVATE_CHANNEL_ID = '你的频道ID';
  const channel = interaction.guild.channels.cache.get(PRIVATE_CHANNEL_ID);
  

4. 确保机器人有权限访问频道
   检查机器人角色是否拥有View Channels权限，且该角色被允许进入目标私人语音频道。如果机器人没有权限，频道不会出现在缓存中。

5. 修正用户语音状态的获取逻辑
   interaction.options.getUser()返回的是全局用户对象，不包含服务器内的语音状态，必须先获取服务器成员对象：

// 替换原有的移动逻辑
try {
  const member1 = await interaction.guild.members.fetch(userOption.id);
  const member2 = await interaction.guild.members.fetch(userTwoOption.id);
  
  await member1.voice.setChannel(channel);
  await member2.voice.setChannel(channel);
  interaction.reply('Users moved successfully.');
} catch (error) {
  console.error(error);
  interaction.reply('An error occurred while moving the users.');
}

完整修复后的示例代码（Discord.js v14+）： #

const { Client, GatewayIntentBits, ChannelType } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildVoiceStates] });

client.on('interactionCreate', async (interaction) => {
  if (!interaction.isCommand()) return;

  if (interaction.commandName === 'move') {
    if (!interaction.member.permissions.has('MOVE_MEMBERS')) {
      return interaction.reply('You do not have permission to move members.');
    }

    const userOption = interaction.options.getUser('user');
    const userTwoOption = interaction.options.getUser('user-two');

    if (!userOption || !userTwoOption) {
      return interaction.reply('Please provide two users to move.');
    }

    // 改用频道ID获取（替换为实际ID）
    const PRIVATE_CHANNEL_ID = '123456789012345678';
    const channel = interaction.guild.channels.cache.get(PRIVATE_CHANNEL_ID);

    if (!channel) {
      return interaction.reply('The "Private Channel" voice channel was not found.');
    }

    try {
      const member1 = await interaction.guild.members.fetch(userOption.id);
      const member2 = await interaction.guild.members.fetch(userTwoOption.id);
      
      await member1.voice.setChannel(channel);
      await member2.voice.setChannel(channel);
      interaction.reply('Users moved successfully.');
    } catch (error) {
      console.error(error);
      interaction.reply('An error occurred while moving the users.');
    }
  }
});

client.login('你的机器人Token');

内容的提问来源于stack exchange，提问作者totally-google-drive