Facebook 登录指南

开始前准备

• 准备可用的 Facebook 账户，并允许弹出授权窗口。
• 商户须在后台配置 Facebook App ID/Secret 并激活前台入口后，登录页才会显示 Facebook Logo。
• 首次授权未绑定时，可选择绑定已有本站账户或新建账户。

商户须开通的 Meta 权限

本站 Facebook 登录固定请求以下 OAuth 权限（与后台配置指南、FacebookProvider 一致）：

• public_profile — 姓名和头像（授权弹窗显示「姓名和头像」）
• email — 邮箱（授权弹窗显示「邮箱」）

开发模式下可用应用角色或测试用户验证流程。对普通顾客上线前，须在 Meta「应用审核 / 权限与功能」为上述权限申请 Advanced Access，完成「登录审核」，并将应用切换为正式模式。

登录步骤

1. 在登录页「快捷登录」点击 Facebook Logo。
2. 在 Facebook 确认授权后返回本站。
3. 已绑定则直接登录；未绑定则按提示完成绑定或新建。

常见问题

• 看不到 Facebook 入口？

  请确认后台已激活 Facebook 前台入口，且部件未关闭 enable_facebook。

• Meta 创建应用时找不到「登录」用例？

  新向导的精选/全部列表常无「Facebook 登录」。请滚到底部选「其他」（消费者）或「创建一个没有用例的应用」，创建后再到应用仪表盘添加「Facebook Login」产品；不要用广告类用例代替。

• 跳转 URI 验证器报无效？

  请先把完整回调 URL 粘贴进上方「有效 OAuth 跳转 URI」并保存；验证器只测试、不会自动写入。快捷弹窗还需开启「使用 JavaScript SDK 登录」并登记允许域名。

• 授权页提示「提交登录审核」？

  说明 `public_profile` / `email` 尚未通过 Meta 登录审核。应用角色与测试用户通常仍可点「继续」完成联调；对普通 Facebook 用户上线前必须提交并获批 Advanced Access。

• 看不到 Facebook One Tap？

  本站使用 Meta FedCM One Tap（须点击芯片确认，不做静默自动登录）。需 HTTPS、Chrome 131+、已开启 JS SDK 并登记允许域名；首次用户请点 Logo。关闭后台「未登录 Facebook One Tap」或已登录本站时不会出现。

• 未返回邮箱怎么办？

  部分 Facebook 账户可能不返回邮箱；本站会使用占位邮箱完成绑定，不影响后续一键登录。