开发环境下Rails应用显示500.html而非实际异常的排查求助

• 确认consider_all_requests_local的实际运行值
  别只盯着配置文件，直接在Rails控制台执行Rails.application.config.consider_all_requests_local，或者在控制器/初始化脚本里加puts输出实际值。有些自定义初始化代码或第三方gem可能会动态修改这个配置，导致和文件里的设置不一致。

• 检查中间件栈的完整性和顺序
  运行rails middleware查看输出，重点确认ActionDispatch::DebugExceptions和ActionDispatch::ShowExceptions是否存在且顺序正确——前者负责在本地环境渲染异常详情，后者负责展示静态错误页。如果DebugExceptions缺失或顺序靠后，就会触发静态页逻辑。可以在开发环境配置里强制调整顺序：

  config.middleware.insert_before ActionDispatch::ShowExceptions, ActionDispatch::DebugExceptions
  

• 排查第三方gem的干扰
  检查Gemfile里的监控、错误上报类gem（比如Sentry、Rollbar、Airbrake），这类工具常自动修改异常处理逻辑，甚至替换默认中间件。可以临时注释掉这类gem，重启应用测试是否恢复正常。

• 检查环境变量的影响
  环境变量会覆盖配置文件的设置，执行echo $RAILS_CONSIDER_ALL_REQUESTS_LOCAL或在控制台查看ENV['RAILS_CONSIDER_ALL_REQUESTS_LOCAL']，确认是否被意外设为false。

• 调试异常处理中间件的执行流程
  直接在ActionDispatch::DebugExceptions的call方法里加调试逻辑，看请求是否走到了这个中间件。比如在config/initializers里加初始化脚本：

  module ActionDispatch
    class DebugExceptions
      alias_method :original_call, :call
  
      def call(env)
        puts "DebugExceptions触发，环境变量show_exceptions值：#{env['action_dispatch.show_exceptions']}"
        original_call(env)
      end
    end
  end
  

  重启后触发异常，看控制台是否有输出，判断中间件是否被正常调用。

• 验证请求的local?属性
  Rails的request.local?方法会结合consider_all_requests_local和请求IP判断是否展示本地异常详情。在控制器里加puts request.local?，如果返回false，可能是反向代理导致Rails识别错了客户端IP。可以在开发环境配置里添加信任代理：

  config.action_dispatch.trusted_proxies = %w(127.0.0.1 ::1)
  

  根据实际代理IP调整值。

• 全局搜索隐藏的异常处理逻辑
  用grep -r "rescue_from\|exceptions_app\|show_exceptions" .全代码库搜索，排查是否有遗漏的初始化脚本、引擎代码或全局配置修改了异常处理规则。

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