Rails4升级至Rails5.1.5后遇两类ActionView模板错误求助

我之前帮不少开发者处理过Rails跨版本升级的兼容性坑，针对你遇到的这两个报错，咱们一步步拆解解决：

问题1：NoMethodError: undefined method 'original_exception' for #<ActionView::Template::Error:0x007f243ecd5d48> #

原因分析 #

Rails 5.x 对 ActionView::Template::Error 的API做了调整，移除了旧版的 original_exception 方法，改用Ruby标准异常的 cause 属性来获取根异常。如果你的项目里有自定义的错误处理逻辑（比如错误页面渲染、异常监控代码）还在调用 original_exception，就会触发这个报错。

解决步骤 #

• 全局搜索项目代码里的 original_exception 调用，重点检查控制器的rescue块、错误视图的helper、或者异常处理的初始化文件。
• 将所有 error.original_exception 的调用替换为 error.cause。如果需要临时兼容旧代码逻辑，可以用兼容写法：

  error.cause || error.original_exception
  

• 重启服务器后测试，确认这个报错不再出现。

问题2：ActionView::Template::Error ($map2: (3rem 2.5rem 2rem 1.5rem 1.25rem 1rem 0.75rem) is not a map for 'map-merge') #

原因分析 #

这是Sass编译时的语法错误：map-merge 函数要求传入的参数必须是键值对形式的map，但你的代码里 $map2 是一个纯列表（list），不符合函数参数要求。大概率是因为Rails 5.1升级了内置的Sass版本，对语法的严格性要求更高；或者你使用的第三方样式库（比如Bootstrap、自定义Sass工具库）版本和新Sass不兼容，导致变量定义不符合规范。

解决步骤 #

• 先定位报错的具体文件：查看服务器日志的完整报错栈，找到调用map-merge的.scss文件和对应行号。
• 检查$map2的定义：如果是你自己定义的变量，把它从列表改成map格式，比如：

  // 原来的错误列表形式
  $map2: (3rem 2.5rem 2rem 1.5rem 1.25rem 1rem 0.75rem);
  // 修改为键值对map（键名可根据业务需求调整）
  $map2: (
    xxl: 3rem,
    xl: 2.5rem,
    lg: 2rem,
    md: 1.5rem,
    sm: 1.25rem,
    xs: 1rem,
    xxs: 0.75rem
  );
  

• 如果$map2来自第三方样式库：比如你用了旧版Bootstrap，建议升级到和Rails 5.1兼容的版本（比如Bootstrap 4.x），旧版库的Sass变量可能不符合新Sass的语法要求。
• 手动运行rails assets:precompile测试样式编译，然后重启服务器加载页面，确认崩溃问题解决。

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