API调用在Rest Client正常但浏览器访问失败（Ruby on Rails）

核心原因 #

问题出在allow_browser.rb的拦截逻辑上——这个拦截器会根据请求的User-Agent或请求头信息判断是否允许访问，你的Rest Client请求头和浏览器的请求头存在差异，导致浏览器请求被判定为"不支持的浏览器"，触发406错误并渲染public/406-unsupported-browser.html。和ArticlesController#index渲染layouts/application.html.erb无关，因为Rest Client能正常获取到这个页面，说明控制器逻辑没问题。

排查与解决步骤 #

• 检查allow_browser配置逻辑
  打开config/initializers/allow_browser.rb，查看Lambda里的判断条件：

  # 示例配置，你的逻辑可能类似
  AllowBrowser.configure do |config|
    config.allow = lambda { |browser|
      # 这里可能限制了浏览器版本或类型
      browser.chrome? && browser.version.to_i >= 105 ||
      browser.safari? && browser.version.to_i >= 16
    }
  end
  

  临时把Lambda改成config.allow = lambda { true }，重启服务器后用浏览器访问，如果能正常打开，说明是版本限制阈值设置过高，或者浏览器版本检测逻辑有误。

• 对比请求头差异
  用浏览器开发者工具（F12→网络面板）查看请求的User-Agent和Accept头，再和Rest Client的请求头对比：

  • 浏览器的User-Agent字符串通常包含更复杂的版本信息，比如Chrome最新版本的User-Agent可能带有Chrome/120.0.0.0这类标识，若拦截逻辑对版本号解析错误（比如把带小数点的版本转成整数时出错），就会误判。
  • Rest Client的请求头可能更简单，比如User-Agent: rest-client/2.1.0，刚好绕过了拦截逻辑。

• 打印拦截日志排查
  在allow_browser.rb的Lambda里添加日志，输出浏览器检测信息：

  config.allow = lambda { |browser|
    Rails.logger.info "Browser detection: #{browser.name} #{browser.version}, User-Agent: #{browser.user_agent}"
    # 原判断逻辑
  }
  

  重启服务器后用浏览器访问，查看log/development.log里的日志，就能明确是浏览器类型、版本还是User-Agent字符串导致的拦截。

• 处理自定义拦截逻辑
  如果allow_browser.rb是你自己写的中间件，检查里面的请求头判断代码，比如是否错误地检查了Accept头，把浏览器正常的text/html请求当成了不支持的格式。

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