已设置状态仍报错TypeError: Cannot read properties of null (reading 'status')

我正在开发首个Discord JS机器人，此前已参照方案解决过部分错误，但当前遇到的「TypeError: Cannot read properties of null (reading 'status')」错误令我困惑——我已按多篇教程设置了状态。

错误栈信息：

/home/container/node_modules/@discordjs/collection/src/collection.ts:326
                        if (fn(val, key, this)) results.set(key, val);
       ^
TypeError: Cannot read properties of null (reading 'status')
    at /home/container/index.js:30:78
    at _Collection.filter (/home/container/node_modules/@discordjs/collection/src/collection.ts:326:8)
    at updateChannelDescriptions (/home/container/index.js:30:45)
    at processTicksAndRejections (node:internal/process/task_queues:95:5)

我的index.js代码：

const Discord = require('discord.js');
const client = new Discord.Client({ intents: [
  Discord.GatewayIntentBits.Guilds,
  Discord.GatewayIntentBits.GuildMessages
]})
require('dotenv').config();

const ROLE_CHANNEL_MAP = {
    "123": "456", // Rust role and channel IDs
    "789": "987"  // 7DTD role and channel IDs
};

client.on('ready', () => {
    client.user.setActivity(`a game`, {type: 'PLAYING'});
    client.user.setPresence({status: "online"});
    console.log(`Logged in as ${client.user.tag}!`);
    updateChannelDescriptions();
    setInterval(updateChannelDescriptions, 300); // Updates every 5 minutes
});


async function updateChannelDescriptions() {
    for (const [roleId, channelId] of Object.entries(ROLE_CHANNEL_MAP)) {
        const role = await client.guilds.cache.first().roles.fetch(roleId);
        const channel = await client.guilds.cache.first().channels.cache.get(channelId);

        if (!role || !channel) continue;

        const membersWithRole = role.members;
        const onlineCount = membersWithRole.filter(member => member.presence.status === 'online').size;
        const newDescription = `${role.name} Role Members: ${membersWithRole.size}, Online: ${onlineCount}`;

        channel.setTopic(newDescription)
            .then(updated => console.log(`Channel ${channel.name} description updated.`))
            .catch(console.error);
    }
}

client.login(process.env.BOT_TOKEN);

请问我忽略了什么？

问题根源与解决步骤 #

1. 缺少必要的网关意图 #

Discord.js需要明确声明意图才能获取成员的在线状态和成员数据。当前代码仅添加了Guilds和GuildMessages，缺少获取成员状态必须的GuildPresences和GuildMembers意图。

修改客户端初始化代码：

const client = new Discord.Client({ intents: [
  Discord.GatewayIntentBits.Guilds,
  Discord.GatewayIntentBits.GuildMessages,
  Discord.GatewayIntentBits.GuildPresences,
  Discord.GatewayIntentBits.GuildMembers
]})

注意：GuildPresences和GuildMembers属于特权意图，需要在Discord开发者门户的机器人页面中手动开启这些权限，否则机器人无法正常获取数据。

2. 未处理member.presence为null的情况 #

即使添加了正确的意图，部分成员的presence仍可能为null（比如用户设置隐身、Discord未返回状态数据等）。直接访问member.presence.status会触发空指针错误，需先判断member.presence是否存在。

修改在线人数统计代码，使用可选链操作符避免报错：

const onlineCount = membersWithRole.filter(member => member.presence?.status === 'online').size;

3. 定时器时间设置错误 #

代码中setInterval(updateChannelDescriptions, 300)的300是毫秒，相当于0.3秒更新一次，不符合注释里的“每5分钟更新”要求，还会给API造成不必要的压力。正确的5分钟对应的毫秒数是300000：

setInterval(updateChannelDescriptions, 300000); // 300000毫秒 = 5分钟

4. 依赖client.guilds.cache.first()不稳定 #

如果机器人加入了多个服务器，client.guilds.cache.first()可能返回非目标服务器，导致角色和频道获取失败。建议直接指定目标服务器ID：

const targetGuild = client.guilds.cache.get('你的服务器ID');
// 后续代码替换为targetGuild
const role = await targetGuild.roles.fetch(roleId);
const channel = targetGuild.channels.cache.get(channelId);

内容的提问来源于stack exchange，提问作者Jesse Elser