Ruby on Rails 5.2.5 集成Facebook OAuth时Devise获取邮箱返回NULL如何解决

核心原因说明 #

Facebook Graph API v2.4及以后版本默认不会返回用户邮箱字段，同时如果用户授权时拒绝邮箱权限、账号未绑定验证邮箱，也会返回空值，可按以下步骤逐一排查： #

排查解决步骤 #

1. 修正Devise OmniAuth初始化配置 #

在config/initializers/devise.rb中显式指定邮箱权限和返回字段，同时使用仍在支持期的API版本：

config.omniauth :facebook, ENV['FACEBOOK_APP_ID'], ENV['FACEBOOK_APP_SECRET'],
  scope: 'email', # 申请邮箱访问权限
  info_fields: 'email,name', # 显式指定需要返回的字段
  client_options: { site: 'https://graph.facebook.com/v18.0' } # 建议使用v16+的稳定API版本

修改配置后需要重启Rails服务生效。

2. 处理用户拒绝授权邮箱的场景 #

Facebook允许用户在授权时关闭邮箱权限，需要在回调控制器中增加空邮箱的兼容逻辑，示例代码如下：

# app/controllers/users/omniauth_callbacks_controller.rb
class Users::OmniauthCallbacksController < Devise::OmniauthCallbacksController
  def facebook
    auth_info = request.env['omniauth.auth']
    # 邮箱为空时跳转补填信息页
    if auth_info.info.email.blank?
      session['devise.facebook_auth'] = auth_info.except('extra')
      redirect_to new_user_registration_path, alert: '请补填邮箱完成账号注册'
      return
    end
    # 原有登录逻辑
    @user = User.from_omniauth(auth_info)
    if @user.persisted?
      sign_in_and_redirect @user, event: :authentication
      set_flash_message(:notice, :success, kind: 'Facebook') if is_navigational_format?
    else
      session['devise.facebook_auth'] = auth_info.except('extra')
      redirect_to new_user_registration_path
    end
  end
end

需要同时在config/routes.rb中指定回调控制器：

devise_for :users, controllers: { omniauth_callbacks: 'users/omniauth_callbacks' }

3. 检查User模型的OmniAuth处理方法 #

确保from_omniauth方法正确读取接口返回的邮箱字段：

# app/models/user.rb
class User < ApplicationRecord
  devise :omniauthable, omniauth_providers: [:facebook]
  def self.from_omniauth(auth)
    where(provider: auth.provider, uid: auth.uid).first_or_create do |user|
      # 正确读取邮箱字段
      user.email = auth.info.email
      user.name = auth.info.name
      user.password = Devise.friendly_token[0, 20]
    end
  end
end

4. 确认Facebook应用权限配置 #

如果应用已对外公开，需要在Facebook开发者后台的「权限和功能」板块申请email权限的高级访问，测试阶段使用测试账号无需额外申请。 #

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