Rails嵌套对象渲染partial传参后child变量未定义问题

原始场景逻辑 #

在遍历多层嵌套的分组结构时，需要为有课程的子分组渲染对应的局部视图，原始的ERB遍历逻辑如下：

<% groups.each do |group| %>
  <% group.children.each do |child| %>
    <% if child.lessons.size > 0 %>
      <% render 'child_partial' %>
    <% end %> 
  <% end %>
<% end %>

按照Rails指南提到的本地变量传参规范，尝试以下两种写法传入当前遍历的child对象：
写法一：

<% render 'child_partial', locals: {child: child} %>

写法二：

<% render 'child_partial', object: child %>

在对应的partial文件中调用<%= child.class %>测试变量可用性时，会触发报错：undefined local variable or method 'child' for #<ActionView::Base。

报错的核心原因 #

• 写法一的报错通常来自Rails版本的参数解析差异：Rails 6.1及更早版本允许把partial路径作为第一个位置参数传入，后续跟的locals会被正确解析；但Rails 7+版本对渲染参数的解析做了严格约束，没有用partial:关键字标记模板路径时，后续传入的locals参数不会被识别为局部变量配置，最终导致partial作用域拿不到传入的变量。
• 写法二的报错来自Rails的自动变量命名规则：使用object:参数传参时，Rails会自动以partial的文件名称作为变量名，把传入的对象暴露到partial作用域中，不会自动生成和传入对象同名的child变量。比如渲染名为child_partial的模板时，object: child传入的对象会被命名为child_partial变量，直接调用child自然会触发未定义变量的报错。

正确的传参方案 #

1. 版本兼容的locals传参 #

不管使用哪个版本的Rails，只要将partial路径显式标记为partial关键字参数，再搭配locals配置，就能稳定传递局部变量：

<% render partial: 'child_partial', locals: { child: child } %>

这种写法下，partial作用域会明确收到名为child的局部变量，直接调用child.class即可正常执行，不会触发报错。

2. object参数的正确使用方式 #

如果选择用object:参数简化传参逻辑，可以通过两种调整适配变量访问规则：

• 匹配自动生成的变量名：保持原写法不变，在partial中使用和partial同名的child_partial变量访问传入的对象，即调用<%= child_partial.class %>即可正常获取对象类名。
• 自定义暴露的变量名：搭配as:参数指定需要暴露给partial的变量名，就能继续在partial中用child作为变量名访问传入的对象，写法如下：

  <% render partial: 'child_partial', object: child, as: :child %>
  

  这种写法和直接传locals的效果完全等价，会在partial作用域内生成指向传入child对象的child局部变量。

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