申请Facebook Page Public Content Access权限遇OAuthException错误求助

问题重现 #

调用Meta的pages/search端点时返回以下错误：

{ "error": {
    "message": "(#10) This endpoint requires the 'pages_read_engagement' permission or the 'Page Public Content Access' feature or the 'Page Public Metadata Access' feature. Refer to https://developers.facebook.com/docs/apps/review/login-permissions#manage-pages, https://developers.facebook.com/docs/apps/review/feature#reference-PAGES_ACCESS and https://developers.facebook.com/docs/apps/review/feature#page-public-metadata-access for details.",
    "type": "OAuthException",
    "code": 10,
    "fbtrace_id": "AICjKBRUbuIP8RrzxSfYG1C"
  }
}

已按指引创建测试应用并添加pages_show_list、pages_read_engagement权限，但问题仍存在。

逐一排查步骤 #

• 验证Access Token的有效性与权限
  1. 使用Meta开发者后台的Token Debugger工具检查token：确认pages_read_engagement权限已被授予，且token关联的是正确的测试页面/用户。
  2. 确保获取token时，授权流程中明确请求了pages_read_engagement权限，而非仅在后台配置——测试应用的权限必须通过用户授权流程落地到具体token上。
• 检查测试应用的权限配置
  1. 进入开发者后台「应用审核」→「权限与功能」，确认pages_read_engagement和pages_show_list已被添加到「测试权限」列表中，而非仅在「应用设置」的权限菜单里勾选。
  2. 确认应用处于开发模式且使用的是测试用户/测试页面：开发模式下，应用仅能访问已关联的测试资源，非测试账号的token会触发权限拦截。
• 规范端点调用参数
  1. 必须使用页面级Access Token调用pages/search：用户级token即使拥有页面管理权限，也无法直接调用该端点，需通过/{user-id}/accounts接口获取对应页面的token后再发起请求。
  2. 确保请求包含必要参数（如q），缺失关键参数可能触发权限校验逻辑的误判。
• Meta权限同步与特殊限制
  1. 权限配置后需等待10-15分钟：Meta的权限系统存在同步延迟，刚添加测试权限就调用可能导致校验失败。
  2. 测试应用的搜索范围限制：pages/search在测试环境下仅能搜索已关联的测试页面，无法访问公开非关联页面，若搜索目标不在测试资源范围内会触发权限错误。

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