Discord.js机器人具备管理员权限但无法为非服务器所有者分配角色，出现TypeError: Cannot read properties of undefined (reading 'roles')错误求助

这个错误的核心原因很明确：你通过message.guild.members.cache.get('user id')获取到的member对象是undefined——也就是机器人在本地缓存里找不到这个成员的数据。为什么给你自己（服务器所有者）分配角色能成功？因为你的成员数据几乎肯定在缓存里（毕竟是活跃用户），但其他成员尤其是离线很久的用户，大概率不在机器人的本地缓存中。

下面是几种针对性的解决方案，按可靠性排序：

1. 使用fetch替代缓存获取成员 #

members.fetch()会直接向Discord API请求成员数据，不管该成员是否在本地缓存中，这是最稳妥的解决方法。注意要使用await来等待异步操作完成，所以你的代码需要放在async函数里：

// 确保你的命令处理函数是async的
client.on('messageCreate', async message => {
  // 这里可以加你的命令触发判断，比如判断消息内容是!addrole之类的
  try {
    // 直接从API获取目标成员
    const member = await message.guild.members.fetch('目标用户ID');
    // 分配角色
    const addedRole = await member.roles.add('目标角色ID');
    console.log('成功添加角色:', addedRole);
  } catch (error) {
    console.error('分配角色时出错:', error);
  }
});

2. 检查机器人的角色位置与权限 #

虽然你的错误是成员未找到，但这里还是要提一个常见的坑：即使机器人有管理员权限，也无法给角色位置比机器人自身角色更高的成员分配角色，也不能分配比机器人角色位置更高的角色。

你需要在服务器设置的「角色」页面里，把机器人的角色拖动到所有需要分配的角色的上方，这样才能确保权限生效。

3. 启用成员缓存Intent（可选） #

如果你需要频繁操作服务器成员，可以在机器人初始化时启用GuildMembers Intent，让机器人自动缓存服务器内的成员数据。在Discord.js v14+中，配置如下：

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds, // 必备的服务器基础Intent
    GatewayIntentBits.GuildMembers, // 启用成员缓存
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent // 如果你需要处理消息内容，这个也得加
  ]
});

不过要注意：即使启用了这个Intent，机器人也可能不会缓存所有成员（尤其是超大服务器），所以还是推荐优先用fetch方法来保证可靠性。

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