如何在Ruby on Rails中更友好地显示HAML错误信息？

长期以来，HAML语法错误仅会输出通用错误信息，示例如下：

Encountered a syntax error while rendering template: check .component.container-xl.my-3.no-p
    .component-header
        %div.float-end

使用better_errors gem时，必须滚动至@cause处才能查看实际错误详情：

#<SyntaxError: /USER PATH STUFF ETC/index.html.haml:47: syntax error, unexpected '=' ...:Haml::Util.escape_html_safe((=number_to_human(investment.va... ... ^ >

请问是否有办法将@cause中的错误信息直接显示在顶部？我考虑过fork该gem并自定义UI来实现，但想先看看有没有更简便的方案。

1. 通过初始化钩子修改better_errors的错误展示逻辑 #

无需fork整个gem，在项目中添加初始化代码即可实现：
创建config/initializers/better_errors.rb文件，写入以下代码：

BetterErrors::Middleware.class_eval do
  def render_exception(request, exception)
    # 提取@cause中的错误信息
    cause_msg = exception.cause&.message || ""
    # 将cause信息合并到主错误消息的顶部
    exception.message = "#{cause_msg}\n\n#{exception.message}" if cause_msg.present?
    super(request, exception)
  end
end

重启服务器后，better_errors的错误页面顶部就会直接显示具体的语法错误信息。

2. 补丁HAML，让它直接抛出原始语法错误 #

创建config/initializers/haml_error_patch.rb文件，添加代码：

Haml::Template.class_eval do
  def handle_render_error(error)
    error.is_a?(SyntaxError) ? raise(error) : super
  end
end

这个补丁会让HAML跳过通用错误提示，直接抛出原始的语法错误，better_errors会自动将该错误展示在页面顶部。

3. Fork gem自定义UI（备选方案） #

如果上述方案无法满足需求，再考虑fork better_errors进行定制：

• 克隆gem仓库到本地，找到错误页面的模板文件（通常位于app/views/better_errors目录下）
• 修改模板的渲染逻辑，优先展示exception.cause的错误内容，再显示主错误信息
• 在项目的Gemfile中替换为本地fork版本的gem地址

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