Intuit Developer OAuth2.0授权请求提示scope查询参数缺失问题

核心问题定位 #

你遇到的scope缺失错误大概率是OAuth2::Client初始化时site参数配置错误导致的：当前site参数填写了完整的授权路径，和authorize_url参数重复，会导致oauth2 gem在拼接授权URL时出现路径异常，进而丢失后续携带的scope参数。

排查步骤 #

• 先打印生成的授权URL确认参数是否存在：在返回grant_url前加日志打印逻辑，访问生成地址后直接查看URL中是否携带scope=com.intuit.quickbooks.accounting参数，确认是生成阶段丢失还是请求阶段被拦截。
• 核对oauth2 gem版本：v2.x版本的oauth2 gem对参数拼接逻辑有调整，如果近期升级过gem版本，需要确认参数传递方式是否适配版本要求。
• 排查应用权限：确认QuickBooks开发者后台已为你的应用开启com.intuit.quickbooks.accounting权限，部分情况下权限未开通时平台也会返回scope缺失类错误。
• 排除请求拦截影响：使用无痕模式或curl直接请求生成的授权URL，排查是否是浏览器插件、代理等中间环节删除了URL参数。

修正后的代码示例 #

def get_quickbooks_login_url
  client_id = "MY_ID_KEY"
  client_secret = "MY_SECRET"
  oauth_params = {
     # site填写根域名，不要带授权路径
     site: "https://appcenter.intuit.com",
     authorize_url: "/connect/oauth2",
     token_url: "https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer"
  }
  oauth2_client = OAuth2::Client.new(client_id, client_secret, oauth_params)
  redirect_uri = 'http://localhost:3000/auth_tokens/new?service=quickbooks'
  grant_url = oauth2_client.auth_code.authorize_url(
    scope: "com.intuit.quickbooks.accounting",
    redirect_uri: redirect_uri,
    response_type: "code",
    state: SecureRandom.hex(12)
  )
  # 新增日志方便后续排查
  Rails.logger.info "QuickBooks授权URL：#{grant_url}"
  grant_url
end

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