Bluesky OAuth授权后调用写入API提示“Bad token scope”问题求助

1. 确认令牌实际包含的权限范围 #

拿到OAuth返回的access_token，用JWT解码工具（本地JWT库或离线解码工具均可）解析令牌的payload，查看其中的scope字段，确认是否包含transition:generic。

• 如果解析结果里没有transition:generic，说明授权流程中未成功获取该权限，问题出在授权请求的参数传递环节。

2. 检查授权请求的scope参数格式 #

确保请求授权时的scope参数是完整的空格分隔字符串，格式示例：

scope: 'atproto transition:generic transition:chat.bsky'

• 注意字符串需正确闭合，避免换行或特殊字符导致scope被截断；
• 确认HTTP请求中scope参数的编码正常（空格转义为+或%20是允许的，无其他异常编码）。

3. 尝试显式添加写入细分权限 #

若解析令牌确认包含transition:generic但仍报错，可尝试在scope中显式添加写入相关的细分权限，测试是否能正常调用接口：

scope: 'atproto transition:generic com.atproto.repo.write transition:chat.bsky'

这一步用于验证是否存在transition:generic权限映射的临时问题，显式声明写入权限可绕过此类问题。

4. 核对OAuth应用配置 #

确认在Bluesky开发者后台创建的应用类型为「Browser App」，无额外权限限制。部分应用类型可能默认限制写入操作，需确保配置与文档要求一致。

5. 验证令牌的请求头格式 #

调用写入接口时，确保令牌通过Authorization请求头正确传递，格式示例：

Authorization: Bearer <你的JWT令牌>

避免令牌拼写错误、遗漏Bearer前缀，或请求头格式不符合要求。

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