Rails 6嵌套路由引发NoMethodError路径问题排查

问题描述 #

• 嵌套路由相关报错连续多日未定位根源，Rails框架自动匹配到实际不存在的嵌套路由路径触发错误，暂未明确框架匹配到异常路径的原因
• 错误日志截图：

现有代码配置 #

• 路由配置（config/routes.rb）：

resources :films do
  resources :reviews, except: %i[new show]
end

• 评论控制器代码（app/controllers/reviews_controller.rb）：

class ReviewsController < ApplicationController
  include FilmsOpinions
  before_action :set_film
  before_action :authenticate_user!

  def create
    @review = @film.reviews.build review_create_params

    if @review.save
      flash[:success] = t 'contacts.create.success'
      redirect_to film_path(@film)
    else
      load_film_reviews(do_render: true)
    end
  end

  private

  def review_create_params
    params.require(:review).permit(:title, :desc).merge(user: current_user)
  end

  def set_film
    @film = Film.find params[:film_id]
  end
end

• 评论表单局部视图（app/views/reviews/_form.html.haml）：

= render 'shared/errors', object: @review

= form_with model: [@film, @review] do |f|
  .form-group
    label.input-label.text-white  = t(".title")
    = f.text_field :title, class: "form-control"

  .form-group
    label.input-label.text-white = t(".please_add_your_reviews")
    = f.text_area :desc, class: "form-control rounded-0"

  .btn-primary
    = f.submit t("submit")

• 电影详情页渲染逻辑（app/views/films/show.html.haml）：

= render 'reviews/form'

问题定位与修复 #

核心问题：表单渲染时传入的@review实例不符合form_with路由推断要求，导致框架生成了不存在的路由路径

• 第一步先验证路由有效性：在项目根目录执行rails routes | grep review，可以确认当前配置生成的评论相关嵌套路由仅包含index、create、edit、update、destroy，确实没有new、show路由，路由配置本身没有问题。
• 路由匹配错误的根源在表单的模型推断逻辑：form_with model: [@film, @review]会根据传入模型的持久化状态自动拼接路由：
  • 当@review是未持久化的新记录（通过@film.reviews.new/build生成，未存入数据库），表单会自动提交到POST /films/:film_id/reviews的创建路由，符合预期
  • 当@review是已持久化的记录，表单会自动匹配PUT /films/:film_id/reviews/:id的更新路由
  • 当@review为nil或未正确初始化，form_with的路由推断逻辑会异常，生成不存在的路径
• 现有代码的明确问题：films/show页面直接渲染reviews/form局部视图，但没有在对应的动作中初始化供创建使用的新@review实例，表单拿到的@review不符合预期，直接触发路由生成错误。

修复操作 #

1. 在FilmsController的show动作中初始化新评论实例，保证首次进入电影详情页时表单能拿到正确的未持久化对象：

def show
  @film = Film.find(params[:id])
  @review = @film.reviews.new # 补充这行初始化
end

2. 检查FilmsOpinions模块中load_film_reviews方法的逻辑，确认评论创建失败触发渲染时，@review变量保留的是提交失败、带验证错误的原评论对象，不会被覆盖为nil或者其他值。
3. 如果create动作验证失败需要渲染电影详情页，明确指定渲染模板路径，避免跨控制器渲染时实例变量传递异常：

def create
  @review = @film.reviews.build review_create_params
  if @review.save
    flash[:success] = t 'contacts.create.success'
    redirect_to film_path(@film)
  else
    load_film_reviews
    render 'films/show' # 明确指定渲染的模板，不要依赖隐式渲染
  end
end

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