Discord机器人自定义状态设置无法切换勿扰等状态图标问题求助

问题根因定位 #

状态标识无法切换为请勿打扰，本质是两个参数使用错误，和接口限流、SDK故障无关：

• 在线状态参数值非法：discord.js 官方接口识别的合法在线状态枚举中，代表请勿打扰的取值是 dnd，传入的 dnb 属于未定义的无效字符串。SDK对这类非法状态值会做静默处理，直接沿用默认的绿色在线状态，不会抛出可感知的运行时错误，从观感上就像接口完全没有生效。
• setActivity 参数作用错配：setActivity 配置项中传入的 status 字段，并不是用来设置机器人全局在线状态的，这个参数仅控制当前活动条目的可见权限，传入任何状态值都不会影响机器人侧边栏的状态图标。

正确实现代码 #

同步设置活动文本和全局在线状态，统一通过 setPresence 接口传入全量配置即可，无需拆分多次调用：

client.user.setPresence({
  // 支持的合法状态值: online / idle / dnd / invisible
  status: "dnd",
  activities: [
    {
      name: "work please",
      type: "PLAYING"
    }
  ]
})

补充说明：如果需要临时单独修改在线状态，直接调用 client.user.setStatus("dnd") 即可，传入正确枚举值后10秒内就会在所有同步的客户端视图上更新为请勿打扰的红色标识。

高频踩坑提示 #

• 禁止使用自定义字符串作为状态参数，比如busy、dnb这类非官方枚举值，SDK不会做强校验提示，会直接被忽略
• 避免连续多次拆分调用setStatus和setActivity，多次请求会导致状态标识、活动文本出现短暂闪断，统一走setPresence配置可以规避这个问题
• 状态更新存在客户端同步延迟，调用完成后如果本地视图没有立刻变化，无需重复调用接口，等待同步窗口结束后即可看到正确状态。

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