嵌套控制器Shared::ResourcesController无法渲染application布局的技术问询

问题背景 #

需求是从嵌套控制器Shared::ResourcesController#show中，以app/layouts/application.html.erb作为布局渲染视图。控制器结构如下：

app/controllers
├── application_controller.rb
├── calendars_controller.rb
├── events_controller.rb
├── shared
│	├── base_controller.rb
│	├── resources_controller.rb

在Shared::BaseController中，通过服务识别资源并设置@resource实例变量（可能是Calendar或Event）。原本配置让所有继承该控制器的类使用app/views/layouts/application.html.erb布局：

# app/controllers/shared/base_controller.rb
module Shared
  class BaseController < ApplicationController
    layout :application
  end
end

# app/controllers/shared/resources_controller.rb  
module Shared
  class ResourcesController < BaseController
    def show
      render @resource
    end
  end
end

布局文件内容：

<!-- app/views/layouts/application.html.erb  -->
<html>
  <head></head>

  <body>
    <%= yield %>
  </body>
</html>

渲染的视图调用部分模板：

<!-- app/views/shared/calendars/_calendar.html.erb -->
<%= render partial: './calendars/calendar_sidebar', locals: { calendar: @resource } %>
<%= render partial: './calendars/calendar' %>

但日志显示布局未被渲染：

Started GET "/fr/shared/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" for 127.0.0.1 at 2023-05-31 14:54:50 +0200
Processing by Shared::ResourcesController#show as HTML
  Parameters: {"locale"=>"fr", "token"=>"[FILTERED]"}
  Calendar Load (1.6ms)  SELECT "calendars".* FROM "calendars" WHERE "calendars"."id" = $1 LIMIT $2  [["id", "ef12946f-de9f-4884-88d1-d9013786cf3c"], ["LIMIT", 1]]
  ↳ app/services/jwt/identify_resource_service.rb:15:in `execute'
  Rendered ./calendars/_calendar_sidebar.html.erb (Duration: 4.5ms | Allocations: 1192)
  Rendered ./calendars/_calendar.html.erb (Duration: 0.4ms | Allocations: 116)
  Rendered shared/calendars/_calendar.html.erb (Duration: 8.4ms | Allocations: 1974)
Completed 200 OK in 25ms (Views: 12.7ms | ActiveRecord: 1.6ms | Allocations: 3955)

此前使用单独控制器（如calendars_controller、events_controller）时正常，改用嵌套控制器后无法渲染正确布局。需解决：如何为嵌套控制器配置布局？例如从控制器B::B中渲染布局A（对应结构：app/views/A.html.erb，app/controllers/B/B.rb）。

解决方案 #

核心问题：调用render @resource时，Rails默认渲染对应的部分模板（文件名以下划线开头），而部分模板默认不加载布局，这与控制器是否嵌套无关。

方法1：显式指定布局渲染 #

修改ResourcesController#show方法，在渲染实例时强制指定布局：

# app/controllers/shared/resources_controller.rb  
module Shared
  class ResourcesController < BaseController
    def show
      render @resource, layout: 'application'
    end
  end
end

或者更明确地指定模板路径：

def show
  render template: "shared/#{@resource.class.name.underscore.pluralize}/#{@resource.class.name.underscore}", layout: 'application'
end

方法2：修正BaseController布局配置 #

原代码中layout :application传递的是符号，Rails会尝试调用同名方法获取布局名。若没有该方法，应直接传递字符串：

# app/controllers/shared/base_controller.rb
module Shared
  class BaseController < ApplicationController
    layout 'application' # 改为字符串形式
  end
end

注意：此修正仅规范配置，仍需结合方法1的显式布局参数，才能让render @resource加载布局。

补充：渲染完整模板而非部分模板 #

若你的视图不是部分模板（文件名无下划线），可直接渲染模板路径，此时会自动应用控制器指定的布局：

def show
  render template: "shared/calendars/calendar" # 对应app/views/shared/calendars/calendar.html.erb
end

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