OAuthException code 190问题：有效权限令牌发布内容失败排查

我们运营一个仅支持帖子排期/发布（无消息功能）的社交媒体发布平台，允许用户关联Facebook主页和Instagram账号。
已获得以下权限的高级访问权（Advanced Access）：

• pages_read_engagement
• pages_read_user_content
• pages_show_list
• instagram_basic
• public_profile

问题现象 #

部分用户在生产环境发布内容到Facebook主页或Instagram（通过Facebook）时，触发OAuthException code 190错误：

"在模拟用户主页之前，必须授予pages_read_engagement、pages_manage_metadata、pages_read_user_content、pages_manage_ads、pages_show_list或pages_messaging中的任一权限。"

经/debug_token验证，令牌未过期且有效。用户正常关联账号后，曾正常使用一段时间才出现该错误。

推测原因 #

用户的令牌在初始OAuth授权后，悄悄丢失了pages_*类权限，可能原因包括：细粒度权限撤销、主页管理员角色变更、Facebook新主页体验迁移。

已尝试方案 #

在OAuth范围中添加了pages_manage_metadata和pages_messaging权限，并提交了高级访问权的应用审核，但不确定这是否适合仅做内容发布的平台。

1. 为何有效令牌在OAuth授权后会悄悄丢失pages_*类权限？ #

主要有几种明确触发场景：

• 用户主动细粒度撤销：用户可在Facebook账号设置的「应用和网站」中，单独撤销某个pages_*权限，而非解除整个应用关联，这种操作不会主动通知应用。
• 主页角色降级：如果用户在主页的角色被管理员降级（比如从管理员降为编辑），原本基于高角色获得的部分pages_*权限会被自动收回，部分高级权限需要特定主页角色支撑。
• 新主页体验迁移：用户将主页迁移到Facebook新主页体验时，旧的权限映射可能失效，导致令牌中的pages_*权限被系统自动移除。
• 权限审核变动：若应用的高级访问权过期，或Facebook调整权限审核规则，可能会自动收回部分权限，这种情况通常会有开发者后台通知。

2. 对于无收件箱功能的发布平台，请求pages_messaging权限是否是正确修复方案？ #

不是。pages_messaging权限用于访问主页消息收件箱，完全超出内容发布平台的功能范围：不仅会大幅增加应用审核难度（Facebook会要求提供对应功能演示，而你没有相关功能），还会引发用户隐私顾虑。

正确做法是聚焦内容发布核心权限：

• 确保OAuth授权时包含pages_read_engagement、pages_read_user_content、pages_show_list，以及内容发布必需的pages_manage_posts（你之前可能遗漏了这个核心权限）。
• pages_manage_metadata可以保留，它用于管理主页元数据，不涉及额外隐私，且能覆盖错误提示要求的权限范围，适配内容发布场景。

3. 有无无需用户重新关联即可检测或阻止此类权限丢失的方法？ #

• 前置权限检查：在每次发布请求前，调用/me/permissions端点（使用用户令牌），校验所需的pages_*权限是否存在。若发现缺失，引导用户补充授权（无需解除关联，仅需重新确认缺失的权限）。
• Webhook监听：订阅Facebook user对象的permissions字段变更webhook，当用户撤销权限时，应用能实时收到通知，及时提醒用户补充授权。
• 定期批量校验：每月批量验证用户令牌的权限状态，对缺失权限的用户推送站内信或邮件，引导重新授权。

需注意：一旦权限丢失，无法绕过用户授权自动恢复，Facebook OAuth机制要求用户主动确认权限授予。

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