Rails index.html.haml第3行报nil:NilClass无each方法如何解决

报错undefined method 'each' for nil:NilClass的根本原因是：视图中调用each方法的@projects实例变量值为nil。Ruby中nil是NilClass的实例，本身没有实现each方法，调用时直接抛出该异常。

结合Rails的MVC约定，@projects为nil通常是两类问题导致：

• 对应控制器ProjectsController的index动作没有给@projects赋值：比如index方法为空、变量名拼写错误（比如写成单数@project）、条件分支下漏写赋值逻辑，未赋值的实例变量默认值就是nil。
• 额外的语法隐患：当前Haml代码中用= @projects.each do ...的写法是错误的，Haml中=会执行代码并把返回值输出到HTML，遍历循环逻辑应该用-前缀（仅执行代码不输出返回值），否则就算不报错也会把集合对象的字符串表示插到页面里。

按以下步骤调整即可解决：

1. 补全控制器赋值逻辑
   打开app/controllers/projects_controller.rb，在index动作中完成@projects的赋值，确保所有逻辑分支下该变量都不会为nil：

class ProjectsController < ApplicationController
  def index
    # 常规查询所有项目的逻辑，无匹配数据时ActiveRecord会返回空集合，不会返回nil
    @projects = Project.all
    # 如果有筛选、分页需求替换为对应逻辑即可，例如：
    # @projects = Project.where(public: true).order(created_at: :desc).page(params[:page])
  end
end

2. 修正Haml视图的遍历语法
   调整app/views/projects/index.html.haml的代码，把循环前缀从=改成-，正确代码如下：

- @projects.each do |project|
  = project.name
  %br

3. （可选）增加兜底防御
   如果存在特殊场景下@projects可能未赋值的情况，可以用Array()方法做兼容，自动把nil转为空数组，避免报错：

- Array(@projects).each do |project|
  = project.name
  %br

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