如何在Ruby/Rails应用中配置统一的5xx默认错误提示？

完全可以实现这个需求，而且能确保覆盖所有现有及未来新增的5xx类错误，以下是两种可靠的实现方案：

方案一：中间件拦截（最彻底，覆盖所有5xx场景） #

通过自定义Rails中间件，在响应返回前拦截所有5xx状态码的请求，统一替换响应内容。这种方式能覆盖包括系统级异常、手动抛出的5xx错误、甚至服务器转发的5xx响应（如502）。

1. 创建中间件文件：

# app/middlewares/unify_5xx_errors.rb
class Unify5xxErrors
  def initialize(app)
    @app = app
  end

  def call(env)
    status, headers, response = @app.call(env)
    
    # 匹配所有5xx状态码（500-517）
    if status.between?(500, 517)
      # 替换为你的通用错误提示，可根据需求用plain/text或HTML
      generic_response = ["服务器内部错误，请稍后重试"]
      # 保持原状态码和响应头（可按需修改headers，比如Content-Type）
      [status, headers, generic_response]
    else
      [status, headers, response]
    end
  end
end

2. 注册中间件：
   在config/application.rb中添加以下配置：

config.middleware.use Unify5xxErrors

方案二：自定义错误控制器+路由接管 #

通过Rails的exceptions_app配置，让路由接管错误处理，将所有5xx错误指向同一个控制器动作，返回统一内容。

1. 创建错误控制器：

# app/controllers/errors_controller.rb
class ErrorsController < ApplicationController
  # 禁用CSRF验证，避免错误页面触发验证失败
  skip_before_action :verify_authenticity_token

  def generic_5xx
    # 获取原错误状态码（从路由路径中提取，比如/500对应500）
    error_status = request.path[1..-1].to_i
    # 返回通用提示，可改用render template渲染HTML页面
    render plain: "服务器内部错误，请稍后重试", status: error_status
  end
end

2. 添加路由规则：
   在config/routes.rb中添加匹配所有5xx路径的路由：

# 匹配500-517的所有5xx错误路径
match "/5(0[0-9]|1[0-7])", to: "errors#generic_5xx", via: :all

3. 配置Rails使用路由处理异常：
   在config/application.rb（或对应环境配置文件，如config/environments/production.rb）中设置：

config.exceptions_app = self.routes

注意事项 #

• 状态码保留：无论用哪种方案，都要保留原有的5xx状态码，不要修改为200或其他状态，这符合HTTP规范，也便于客户端识别错误类型。
• 开发环境测试：开发环境默认会显示详细错误栈，若要测试通用提示，可在config/environments/development.rb中设置config.consider_all_requests_local = false。
• 覆盖范围：两种方案都能覆盖未来工程师新增的5xx错误（包括手动抛出的raise ..., status: :internal_server_error这类异常），无需额外修改。

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