Doorkeeper从5.1.0升级到5.2.1后出现Missing required parameter: scope错误

你遇到的是Doorkeeper 5.2.x版本对scope参数校验逻辑变更导致的问题——即使你不使用权限范围（scopes），新版本也要求请求中必须存在scope参数（可以是空字符串），而旧版本可能允许该参数缺失。下面是具体的解决步骤：

1. 配置Doorkeeper默认空Scope #

首先在config/initializers/doorkeeper.rb中明确设置默认scope为空，同时声明没有可选scope：

Doorkeeper.configure do
  orm :active_record
  # 添加以下两行配置
  default_scopes ''
  optional_scopes []

  resource_owner_authenticator do
    current_admin_user || redirect_to(new_admin_user_session_path(params.permit(:client_id, :redirect_uri, :response_type, :state)))
  end
  admin_authenticator do
    current_admin_user || redirect_to(new_admin_user_session_path)
  end
  access_token_expires_in 24.hours
end

这个配置告诉Doorkeeper默认使用空的权限范围，不需要额外的scope定义。

2. 确保授权请求携带Scope参数 #

如果你的登录跳转逻辑中没有传递scope参数，需要在resource_owner_authenticator里补上默认的空scope，避免参数缺失：

resource_owner_authenticator do
  # 合并参数时确保scope存在，为空字符串（如果原请求没有的话）
  auth_params = params.permit(:client_id, :redirect_uri, :response_type, :state, :scope).merge(scope: params[:scope] || '')
  current_admin_user || redirect_to(new_admin_user_session_path(auth_params))
end

这样当用户被重定向到登录页时，scope参数会被正确携带，后续授权流程就能通过校验。

3. （可选）重写授权控制器强制设置Scope #

如果上面的配置仍未解决问题，可以重写Doorkeeper的授权控制器，手动将nil的scope转为空字符串：

# app/controllers/doorkeeper/authorizations_controller.rb
module Doorkeeper
  class AuthorizationsController < ApplicationController
    def new
      pre_auth = PreAuthorization.new(server, pre_auth_params)
      # 当scope为nil时强制设置为空字符串
      pre_auth.scope = '' if pre_auth.scope.nil?

      if pre_auth.authorizable?
        if skip_authorization? || matching_token_exists?
          redirect_to authorization_code_grant.redirect_uri
        else
          render :new
        end
      else
        redirect_to pre_auth.error_uri
      end
    end
  end
end

这个方法直接在授权流程的入口修正了scope参数，绕过了参数缺失的校验。

问题根源说明 #

Doorkeeper 5.2.x版本对OAuth请求的参数校验做了强化，即使不使用scopes功能，也要求scope参数必须存在（值可以为空）。你之前执行的数据库迁移只是处理了oauth_access_grants表的字段约束，但没有解决请求层面的参数缺失问题——调试中看到的pre_auth.scope为nil，正是触发校验错误的直接原因。

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