跳至内容 跳至搜索

Action Dispatch ShowExceptions

此中间件会捕获应用程序返回的任何异常,并调用一个异常处理应用,该应用会将异常包装成面向最终用户的格式。

在初始化 ShowExceptions 时,需要将异常处理应用作为参数传入。每次发生异常时,ShowExceptions 都会将异常存储在 env["action_dispatch.exception"] 中,将 PATH_INFO 重写为异常的状态码,然后调用 Rack 应用。

Rails 应用程序中,可以通过 config.exceptions_app 来配置异常处理应用,默认情况下是 ActionDispatch::PublicExceptions

如果应用程序返回的响应中 X-Cascade 标头被设置为 "pass",则此中间件将以正确的状态码返回一个空响应。如果在异常处理应用内部发生任何异常,此中间件会捕获这些异常并返回一个备用响应。

方法
C
N

类公共方法

new(app, exceptions_app)

# File actionpack/lib/action_dispatch/middleware/show_exceptions.rb, line 26
def initialize(app, exceptions_app)
  @app = app
  @exceptions_app = exceptions_app
end

实例公共方法

call(env)

# File actionpack/lib/action_dispatch/middleware/show_exceptions.rb, line 31
def call(env)
  @app.call(env)
rescue Exception => exception
  request = ActionDispatch::Request.new env
  backtrace_cleaner = request.get_header("action_dispatch.backtrace_cleaner")
  wrapper = ExceptionWrapper.new(backtrace_cleaner, exception)
  request.set_header "action_dispatch.exception", wrapper.unwrapped_exception
  request.set_header "action_dispatch.report_exception", !wrapper.rescue_response?

  if wrapper.show?(request)
    render_exception(request.dup, wrapper)
  else
    raise exception
  end
end