如何解决DiscordAPIError[10002]: Unknown Application错误？

问题描述 #

我在开发Discord机器人时碰到了DiscordAPIError[10002]: Unknown Application错误，不清楚问题所在，请求协助排查。

报错信息 #

There was an error: DiscordAPIError[10002]: Unknown Application

相关代码 #

require('dotenv').config();
const { REST, Routes, ApplicationCommandOptionType } = require('discord.js');

const commands = [
    {
        name: 'embed',
        description: 'Sends an embed!', 
        options: [
            {
                name: 'title',
                description: 'Title of embed',
                type: ApplicationCommandOptionType.String,
                required: true,
            },
            {
                name: 'description',
                description: 'The description of embed',
                type: ApplicationCommandOptionType.String,
                required: false,
            },
            {
                name: 'color',
                description: 'The color of embed',
                type: ApplicationCommandOptionType.String,
                required: false,
                choices: [
                    {
                        name: 'red',
                        value: 'ED4245',
                    },
                    {
                        name: 'green',
                        value: '57F287',
                    },
                    {
                        name: 'blue',
                        value: '3498DB',
                    },
                    {
                        name: 'yellow',
                        value: 'FFFF00',
                    },
                    {
                        name: 'white',
                        value: 'FFFFFF',
                    },
                    {
                        name: 'gold',
                        value: 'F1C40F',
                    },
                    {
                        name: 'orange',
                        value: 'E67E22',
                    },
                ]
            },
        ]
    },
];

错误原因及解决步骤 #

这个错误核心是Discord API无法识别你传入的机器人应用ID，按以下步骤排查：

• 核对应用ID正确性
  打开Discord开发者门户，找到你的机器人应用，确认APPLICATION ID和代码（或.env文件）中使用的完全一致，别把它和机器人TOKEN、服务器GUILD ID搞混。

• 检查.env文件配置
  确保.env文件里正确定义了CLIENT_ID（即应用ID），且代码通过process.env.CLIENT_ID正确读取。注册命令的代码中，Routes路径必须正确传入这个ID，示例如下：

  const rest = new REST({ version: '10' }).setToken(process.env.TOKEN);
  
  (async () => {
      try {
          await rest.put(
              Routes.applicationCommands(process.env.CLIENT_ID),
              { body: commands },
          );
          console.log('Successfully registered application commands.');
      } catch (error) {
          console.error(error);
      }
  })();
  

  同时确认.env文件没有拼写错误，比如把CLIENT_ID写成CLIENTID这类变体。

• 验证机器人状态与权限
  确认机器人已邀请到目标服务器，且拥有applications.commands权限；检查开发者门户中应用状态正常，没有被封禁或限制。

• 匹配API与Discord.js版本
  确保使用的Discord.js版本和REST API版本兼容，比如代码中REST({ version: '10' })对应Discord.js v14，不要混用不同版本的API路径。

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