集成Agora Whiteboard报token access room forbidden错误如何解决

报错复现 #

集成Agora Whiteboard到自有网站运行时，抛出如下错误导致无法加入房间：

[White] Error: connect failed: cannnot join room: token access room forbidden

错误核心原因为当前使用的token无目标房间访问权限，可按以下顺序逐一排查修复：

• 校验入参一致性：生成白板token时传入的appIdentifier、目标房间UUID，必须和前端初始化白板SDK、调用加入房间接口时传入的参数完全一致。注意区分Agora音视频SDK的App ID和白板服务的App Identifier，二者是独立凭证，混用会直接触发权限拦截。
• 检查token有效性与权限范围：如果使用的是有时效的临时token，先确认token未超出有效期；生成token时若指定了角色权限（只读/读写），需确认当前场景使用的token角色匹配操作权限，例如需要编辑白板的场景不能使用只读角色生成的token。
• 确认房间与项目状态：核实目标白板房间已通过服务端接口正常创建，未被封禁、删除；同时确认白板所属的Agora项目状态正常，无欠费、违规被限制服务的情况。
• 核对区域配置：Agora白板服务分多个数据中心区域，生成token、创建房间、前端初始化SDK三个环节配置的服务区域必须完全一致，跨区访问会导致token校验不通过。
• 排查token生成逻辑：如果是自行编码生成token，需确认签名算法、字段拼接顺序符合规则，无漏填字段、错用项目密钥的问题。注意区分项目级SDK Token和房间级Token，加入房间必须使用对应目标房间生成的房间级Token，不能直接用项目级SDK Token入房。

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