如何在Rails应用全局统一显示规范的HTTP状态码页面？

作为Rails开发者，我之前也遇到过完全一样的需求——不想在每个控制器里重复写错误处理代码，希望所有非200状态都自动显示统一风格的提示页面。下面是我常用的两种原生实现方案，不用依赖额外gem：

方案一：全局异常捕获（覆盖控制器抛出的异常） #

在你的ApplicationController里添加全局的rescue_from规则，捕获常见的HTTP错误异常，统一渲染自定义错误视图：

class ApplicationController < ActionController::Base
  # 捕获常见的HTTP错误异常
  rescue_from ActiveRecord::RecordNotFound, with: :render_custom_error
  rescue_from ActionController::RoutingError, with: :render_custom_error
  rescue_from ActionController::Unauthorized, with: :render_custom_error
  rescue_from ActionController::Forbidden, with: :render_custom_error

  # 生产环境下捕获其他未处理的异常（避免泄露敏感信息）
  rescue_from StandardError, with: :render_internal_server_error unless Rails.env.development?

  private

  def render_custom_error(exception)
    # 根据异常类型映射对应的HTTP状态码
    status = case exception
             when ActiveRecord::RecordNotFound, ActionController::RoutingError
               :not_found # 404
             when ActionController::Unauthorized
               :unauthorized # 401
             when ActionController::Forbidden
               :forbidden # 403
             else
               :internal_server_error # 500
             end

    # 渲染对应的错误视图，使用自定义布局
    render "errors/#{status}", status: status, layout: 'error'
  end

  def render_internal_server_error(exception)
    # 记录异常日志方便排查
    Rails.logger.error("Server Error: #{exception.message}\n#{exception.backtrace.join("\n")}")
    render "errors/internal_server_error", status: :internal_server_error, layout: 'error'
  end
end

方案二：路由层面的Catch-All（处理不存在的路由） #

上面的方法能处理控制器内的异常，但如果用户访问了完全不存在的路由（比如/random-invalid-path），需要在routes.rb末尾添加一个捕获所有路由的规则，引导到错误控制器：

Rails.application.routes.draw do
  # 你的所有业务路由...

  # 捕获所有未匹配的路由，指向404错误页面
  match '*unmatched_path', to: 'errors#not_found', via: :all
end

然后创建对应的ErrorsController：

class ErrorsController < ApplicationController
  # 禁用CSRF验证（因为错误页面可能来自跨站请求或无效路由）
  skip_before_action :verify_authenticity_token

  def not_found
    render "errors/not_found", status: :not_found, layout: 'error'
  end

  def unauthorized
    render "errors/unauthorized", status: :unauthorized, layout: 'error'
  end

  def forbidden
    render "errors/forbidden", status: :forbidden, layout: 'error'
  end
end

准备自定义错误视图和布局 #

接下来创建对应的视图文件，统一放在app/views/errors目录下：

• not_found.html.erb（404页面）：

<h1>404 - 页面不存在</h1>
<p>抱歉，你访问的页面不存在或已被移除。</p>
<p><%= link_to '返回首页', root_path %></p>

• unauthorized.html.erb（401页面）：

<h1>401 - 未授权访问</h1>
<p>请先登录后再尝试访问此资源。</p>
<p><%= link_to '去登录', login_path %></p>

• forbidden.html.erb（403页面）：

<h1>403 - 无权访问</h1>
<p>你没有权限访问此资源，请联系管理员获取权限。</p>
<p><%= link_to '返回首页', root_path %></p>

• internal_server_error.html.erb（500页面）：

<h1>500 - 服务器内部错误</h1>
<p>抱歉，服务器出现了问题，请稍后再试。</p>
<p><%= link_to '返回首页', root_path %></p>

然后创建一个专门的错误页面布局app/views/layouts/error.html.erb，确保所有错误页面风格统一：

<!DOCTYPE html>
<html>
<head>
  <title><%= yield :title %></title>
  <%= stylesheet_link_tag 'application', media: 'all' %>
</head>
<body>
  <div class="error-page">
    <%= yield %>
  </div>
</body>
</html>

开发环境测试自定义错误页面 #

默认情况下，Rails开发环境会显示详细的调试错误页面，如果你想在开发环境测试自定义页面，可以修改config/environments/development.rb：

# 关闭本地请求详细错误提示
config.consider_all_requests_local = false

关于Heroku的注意事项 #

Heroku默认会在应用返回500/404时显示它的默认页面，但只要你的应用正确返回对应的HTTP状态码和自定义视图，Heroku就会优先显示你的页面。确保生产环境下你的错误视图能正常渲染即可。

这样设置后，不管是用户访问未授权资源、不存在的页面，还是服务器内部出错，都会自动显示你定义的通用提示页面，完全不用逐个修改控制器！

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