Discord.js V14 Cron定时获取指定服务器成员详情失败求助

核心问题分析 #

你遇到的Collection(0) [Map] {}空成员列表问题，主要由两个关键原因导致：

1. 客户端未完成初始化就执行成员获取逻辑 #

client.login()是异步操作，调用updateMembers()时，Discord客户端还未完成登录、握手和数据同步，此时guild.members.cache自然为空。

2. 成员缓存不会自动全量加载 #

即使客户端就绪，guild.members.cache默认仅存储已触发缓存的成员（比如最近发送消息、上线的用户），不会自动拉取服务器所有成员。必须主动调用成员获取接口才能拿到全量数据。

修复后的代码示例 #

const dotenvFlow = require('dotenv-flow');
const { Client, Partials, GatewayIntentBits } = require('discord.js');
dotenvFlow.config();

// Create a new client instance
const client = new Client({ 
  intents: [
    GatewayIntentBits.Guilds, 
    GatewayIntentBits.MessageContent, 
    GatewayIntentBits.GuildIntegrations, 
    GatewayIntentBits.GuildMembers, 
    GatewayIntentBits.GuildMessages, 
    GatewayIntentBits.DirectMessageTyping, 
    GatewayIntentBits.DirectMessages
  ], 
  partials: [Partials.Channel] 
});

// Get the guild object
async function updateMembers() {
  console.log("Starting...")

  // 确保客户端已就绪
  if (!client.isReady()) {
    console.log("等待客户端就绪...");
    await new Promise(resolve => client.once('ready', resolve));
  }

  const guild = await client.guilds.fetch(process.env.hostDiscordServer);
  // 主动拉取全量成员（替换原有的cache直接读取）
  const members = await guild.members.fetch();

  // Insert or update each member in the database
  members.forEach(member => {
    // 此处判断可省略，因为members就是当前guild的成员集合
    // if (member.guild.id === guild.id) {
      // Get the member's premium role
      const pRole = member.roles.cache.find(role => 
        [process.env.pPremiumRole1, process.env.pPremiumRole2, process.env.pPremiumRole3].includes(role.name)
      )?.name;
      console.log("Inserting into DB")
      // Insert or update the member's record in the database
      console.log(member.id)
      console.log(pRole)
    // }
  });
}

// Log in to Discord with your client's token
client.login(process.env.DISCORD_TOKEN);

// 定时执行建议在客户端就绪后启动，避免未初始化问题
client.once('ready', () => {
  console.log('客户端已就绪');
  // 替换为你的Cron定时逻辑，示例：
  // const cron = require('node-cron');
  // cron.schedule('*/5 * * * *', updateMembers);
  
  // 测试用：立即执行一次
  updateMembers();
});

额外注意事项 #

• 仅代码中声明GuildMembers意图不够，需在Discord开发者平台的机器人页面，手动开启服务器成员特权网关意图（Guild Members Intent）。
• 若定时任务间隔较长，建议让机器人保持在线状态，避免重复登录的开销；若必须离线执行，需在每次任务启动时确保客户端完成登录就绪流程。

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