discord.js如何实现用户离开后保留Muted角色并解决Unknown Member报错

问题1：被禁言用户离开服务器后Muted角色被移除 #

Discord 原生机制就是用户退出服务器时，系统会自动清除该用户在当前服务器的所有角色绑定关系，没有方法可以绕过这个逻辑在用户离服状态下保留角色。
可通过以下方案解决：

• 自建持久化存储记录禁言状态，可选SQLite、JSON文件、Redis等任意存储方式，存储字段至少包含guild_id（服务器ID）、user_id（被禁言用户ID）、expire_at（禁言到期时间戳，永久禁言可设为null）
• 监听guildMemberAdd（成员加入服务器）事件，每次有用户加入时查询你的禁言存储：如果该用户存在当前服务器的未到期禁言记录，直接为其重新分配Muted角色即可

参考实现（基于discord.js v14）：

// 成员加入服务器事件监听
client.on('guildMemberAdd', async (member) => {
  // 从自定义存储查询有效禁言记录，以下为示例查询逻辑，替换为你自己的存储查询代码
  const validMuteRecord = await yourDB.query('mute_records', {
    guild_id: member.guild.id,
    user_id: member.id,
    expire_at: { $gt: Date.now() }
  })

  if (validMuteRecord) {
    // 替换为你服务器的Muted角色ID
    const mutedRole = member.guild.roles.cache.get('YOUR_MUTED_ROLE_ID')
    if (mutedRole) {
      await member.roles.add(mutedRole).catch(console.error)
    }
  }
})

问题2：操作离服用户抛出Unknown Member错误 #

该错误触发原因是你尝试对已经不在服务器内的用户执行成员类操作（比如添加/移除角色、修改昵称等），Discord API 找不到对应成员对象就会返回该错误。
可通过两层防护解决：

• 执行成员操作前先尝试拉取成员对象，拉取不到说明用户已离服，直接跳过后续操作
• 所有成员操作代码添加错误捕获，专门拦截Unknown Member错误忽略处理

参考实现（基于discord.js v14）：

async function addMuteRole(guild, userId, mutedRole) {
  try {
    // 先拉取成员对象，拉取不到直接返回
    const targetMember = await guild.members.fetch(userId).catch(() => null)
    if (!targetMember) return

    await targetMember.roles.add(mutedRole)
  } catch (err) {
    // Discord API 错误码10007对应Unknown Member，直接忽略
    if (err.code === 10007) return
    // 其他错误正常抛出处理
    console.error('禁言操作失败', err)
  }
}

你在执行?s mute @user指令的逻辑中直接调用上面封装好的方法即可，不需要额外处理离服用户的场景。

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