Ruby on Rails中捕获所有控制器响应状态上报指标的问题

我来帮你搞定这个问题，核心原因是你用rescue_from的时机不对——当控制器的rescue_from回调触发时，Rails还没完成异常响应的状态设置流程，所以response.status还是默认的200，自然拿不到正确的错误状态码。下面给你两种实用的解决方案：

方案一：用中间件捕获所有请求的最终状态（推荐） #

中间件处于Rails请求处理链路的最外层，不管是正常响应还是异常处理后的最终响应，都能拿到真实的状态码，这是覆盖所有场景最稳妥的方式。

步骤1：创建中间件文件 #

在app/middlewares/目录下新建status_metric_middleware.rb：

require 'statsd-ruby'

class StatusMetricMiddleware
  def initialize(app)
    @app = app
  end

  def call(env)
    # 先让请求走完整个Rails处理流程，拿到最终的响应三元组（状态码、头、响应体）
    status, headers, response = @app.call(env)
    
    # 排除健康检查路径
    request = ActionDispatch::Request.new(env)
    unless request.fullpath == '/health'
      statsd = Statsd.new ENV['STATSD_LOCATION'], ENV['STATSD_PORT']
      normalized_status = normalize_status_metric(status)
      statsd.increment("ds.status.#{normalized_status}.int")
    end

    # 把响应传递给下一个中间件/客户端
    [status, headers, response]
  end

  private

  def normalize_status_metric(status)
    return 100 if status >= 100 && status < 200
    return 200 if status >= 200 && status < 300
    return 300 if status >= 300 && status < 400
    return 400 if status >= 400 && status < 500
    return 500 if status >= 500 && status < 600
    0
  end
end

步骤2：注册中间件 #

在config/application.rb里添加中间件注册代码：

module YourAppName
  class Application < Rails::Application
    # 其他配置...
    config.middleware.use StatusMetricMiddleware
  end
end

这个方案能完美覆盖ActionController::RoutingError、ActiveRecord::RecordNotFound等所有异常场景，因为中间件拿到的是Rails处理完所有逻辑后的最终状态码。

方案二：改进rescue_from，手动映射异常到状态码 #

如果不想用中间件，也可以在控制器层面通过识别异常类型，手动设置对应的状态码后再上报指标。

修改你的ApplicationController代码：

require 'statsd-ruby'

class ApplicationController < ActionController::API
  after_action :push_status_metric

  # 捕获所有异常并处理指标上报
  rescue_from StandardError, with: :handle_exception_for_metric

  def push_status_metric
    return if request.fullpath == '/health'
    
    statsd = Statsd.new ENV['STATSD_LOCATION'], ENV['STATSD_PORT']
    normalized_status = normalize_status_metric(response.status)
    statsd.increment("ds.status.#{normalized_status}.int")
  end

  private

  def handle_exception_for_metric(exception)
    return if request.fullpath == '/health'
    
    statsd = Statsd.new ENV['STATSD_LOCATION'], ENV['STATSD_PORT']
    # 根据异常类型匹配对应的HTTP状态码
    status_code = case exception
                  when ActionController::RoutingError, ActiveRecord::RecordNotFound
                    404
                  when ActionController::BadRequest, ActionController::ParameterMissing
                    400
                  when ActionController::Unauthorized
                    401
                  # 可以根据业务需求添加更多异常类型
                  else
                    500
                  end
    normalized_status = normalize_status_metric(status_code)
    statsd.increment("ds.status.#{normalized_status}.int")

    # 重新抛出异常，让Rails继续处理（比如渲染错误JSON响应）
    raise exception
  end

  def normalize_status_metric(status)
    return 100 if status >= 100 && status < 200
    return 200 if status >= 200 && status < 300
    return 300 if status >= 300 && status < 400
    return 400 if status >= 400 && status < 500
    return 500 if status >= 500 && status < 600
    0
  end
end

这个方案需要你手动维护异常类型和状态码的映射，好处是在控制器层面处理，但缺点是容易遗漏某些异常类型，不如中间件方案全面。

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