Ruby on Rails项目Omniauth Facebook功能跳转URL被拦截问题求助

重定向URI白名单报错修复 #

URL Blocked: This redirect failed because the redirect URI is not whitelisted in the app’s Client OAuth Settings. Make sure Client and Web OAuth Login are on and add all your app domains as Valid OAuth Redirect URIs
针对以上报错，按顺序执行检查：

• 确认Facebook开发者后台对应应用的「客户端OAuth登录」「Web OAuth登录」两个开关已全部开启
• Valid OAuth Redirect URIs中填写的地址必须与代码内Omniauth配置的回调地址完全一致，协议(http/https)、域名、端口、路径不得有任何差异，末尾多余斜杠也会触发报错
• 测试环境使用localhost时，需同时将localhost添加到应用设置的「应用域名」列表中

本地HTTPS回调报错修复 #

如果填写HTTPS回调地址后出现Puma服务SSL证书相关报错，可选择以下任意一种方案解决：

方案1：本地Puma配置自签名SSL证书（推荐，可复用到其他HTTPS开发需求） #

• 安装mkcert工具后执行命令生成本地信任的自签名证书：
  mkcert localhost 127.0.0.1 ::1
• 修改config/puma.rb配置文件，添加SSL绑定规则：

ssl_bind '0.0.0.0', '3000', {
  key: '本地证书路径/localhost-key.pem',
  cert: '本地证书路径/localhost.pem'
}

• 启动Rails服务后直接通过https://localhost:3000访问，将对应完整HTTPS回调地址填入Facebook后台即可正常使用

方案2：开发模式临时豁免HTTPS要求（仅适用于本地测试） #

• 确认Facebook应用当前处于「开发模式」，只有开发模式下支持localhost的HTTP回调豁免
• 将Omniauth回调地址改为http://localhost:3000/users/auth/facebook/callback，完整填入Facebook后台的Valid OAuth Redirect URIs列表
• 修改Omniauth初始化配置，强制生成HTTP协议的回调地址：
  OmniAuth.config.full_host = 'http://localhost:3000'
• 检查config/environments/development.rb中config.force_ssl配置项的值为false，避免Rails自动跳转HTTPS

注意事项 #

• 方案2仅可用于本地开发测试，生产环境必须配置合规SSL证书，使用HTTPS回调地址
• Facebook后台配置修改后最多需要5分钟生效，修改后等待片刻再进行测试避免误判

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