Discord.js事件处理报错：Cannot read properties of undefined (reading 'get')

错误根源 #

你遇到的 TypeError: Cannot read properties of undefined (reading 'get')，本质是在 interactionCreate.js 中尝试调用 get() 的对象是 undefined——几乎可以确定是 client.commands 没有被正确获取到，因为拆分事件文件后，上下文里的 client 实例没有被正确传递到事件处理函数中。

具体解决步骤 #

1. 修正事件文件的参数接收 #

确保 interactionCreate.js 的导出函数能拿到 client 实例：

// interactionCreate.js
module.exports = {
  name: 'interactionCreate',
  async execute(interaction, client) {
    if (!interaction.isChatInputCommand()) return;

    // 现在client已正确传入，能正常调用commands.get()
    const command = client.commands.get(interaction.commandName);
    if (!command) return;

    try {
      await command.execute(interaction);
    } catch (err) {
      console.error(err);
      await interaction.reply({ content: '命令执行出错！', ephemeral: true });
    }
  }
};

2. 调整事件加载逻辑，传递client实例 #

在 index.js 的事件加载代码中，必须把 client 作为额外参数传给事件的 execute 函数：

// index.js 中的事件加载部分
const fs = require('fs');
const path = require('path');

const eventsDir = path.join(__dirname, 'events');
const eventFiles = fs.readdirSync(eventsDir).filter(f => f.endsWith('.js'));

for (const file of eventFiles) {
  const event = require(path.join(eventsDir, file));
  if (event.once) {
    // 一次性事件也需要传递client
    client.once(event.name, (...args) => event.execute(...args, client));
  } else {
    // 普通事件传递client到execute参数末尾
    client.on(event.name, (...args) => event.execute(...args, client));
  }
}

3. 确认commands集合已初始化 #

在 index.js 中必须提前创建 commands 集合，否则即使拿到client，client.commands 还是undefined：

// index.js 初始化client部分
const { Client, Collection, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

// 这一步必须有，创建commands集合
client.commands = new Collection();

4. 检查命令加载逻辑 #

确保所有命令文件都被正确加载到 client.commands 中：

// index.js 中的命令加载部分
const commandsDir = path.join(__dirname, 'commands');
const commandFiles = fs.readdirSync(commandsDir).filter(f => f.endsWith('.js'));

for (const file of commandFiles) {
  const command = require(path.join(commandsDir, file));
  // 用命令的name作为key存入集合
  client.commands.set(command.data.name, command);
}

总结 #

拆分事件文件后最容易忽略的就是上下文传递——原来在index.js里能直接访问client，拆分后必须通过加载逻辑手动把client传给事件处理函数。按上面的步骤逐一排查，就能解决这个报错。

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