Discord.js ReactionRoles功能部署到Debian 10 VPS无法运行问题求助

1. 核心逻辑错误修复 #

你在messageReactionAdd和messageReactionRemove事件的回调代码中，partial判断逻辑完全错误：

// 你的错误代码
if (message.partial) await reaction.fetch();

这里的message是外层execute函数的参数，即用户触发ReactionRole命令的消息，不是被添加/移除反应的目标消息。你判断了无关消息的partial状态，还去拉取reaction对象，逻辑完全不匹配。
本地测试时所有消息都在运行时缓存中，不会触发partial判断逻辑因此运行正常，VPS部署后缓存清空，这段错误逻辑被触发就会抛出异常。
修正为如下代码即可：

// 修正后代码
if (reaction.partial) await reaction.fetch();

2. 补充Partials配置 #

Discord.js v13及以上版本需要在初始化Client时手动开启相关Partials，才能正常接收非缓存消息的反应事件，请确认你的Client初始化代码包含如下配置：

const { Client, Intents, Partials } = require('discord.js');
const client = new Client({
  intents: [
    Intents.FLAGS.GUILDS,
    Intents.FLAGS.GUILD_MESSAGES,
    Intents.FLAGS.GUILD_MESSAGE_REACTIONS
  ],
  partials: [Partials.Message, Partials.Channel, Partials.Reaction]
});

3. 事件监听器重复注册问题修复 #

你当前的代码每次执行ReactionRole命令，都会给client新增两个事件监听器，执行次数多了会出现单条反应触发多次角色修改、内存泄漏的问题。建议你把messageReactionAdd和messageReactionRemove的监听逻辑移到client初始化的全局代码中，不要放在命令的execute回调里。 #

4. 部署环境校验 #

Debian 10默认源的Node.js版本较低，低于Discord.js要求的最低版本（v13要求Node.js ≥16.6，v14要求Node.js ≥16.9），请确认VPS上的Node.js版本符合你使用的Discord.js版本要求，同时确认机器人角色拥有管理角色权限，且机器人角色排序高于你要分配的目标角色。

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