使用Discord.js编写事件处理器时遇fetch读取未定义属性的TypeError错误

云上老周

2026-7-13

Discord.js TypeError: Cannot read properties of undefined (reading 'fetch') 问题解决

错误原因

这个错误核心是applicationCommands变量变为undefined，导致调用fetch()方法时触发报错，具体问题出在两处：

客户端未就绪时，client.application还未初始化，直接访问client.application.commands会得到undefined
else分支错误地给client.application.commands加了await，它本身是同步获取的管理器对象，不需要异步等待

修复方案

不需要额外执行npm install操作，只需修正代码逻辑并确保客户端状态正确：

1. 确保客户端已就绪

调用该函数前，必须保证Discord客户端已经触发ready事件，否则client.application可能还未完成初始化。

2. 修正代码

module.exports = async (client, guildId) => {
  let applicationCommands;

  if (guildId) {
    const guild = await client.guilds.fetch(guildId);
    if (!guild) throw new Error('无法获取指定服务器');
    applicationCommands = guild.commands;
  } else {
    if (!client.application) throw new Error('客户端应用未初始化，请确保client已完成就绪');
    // 移除多余的await，直接赋值命令管理器
    applicationCommands = client.application.commands;
  }

  await applicationCommands.fetch();
  return applicationCommands;
};