Rails 4：ActiveAdmin布局空白，自定义控制器动作仅application布局生效

这个问题我维护老Rails项目时也碰到过，核心原因其实是ActiveAdmin的布局 fallback 机制和Rails全局布局的叠加渲染：当你删除或重命名active_admin.html.erb后，ActiveAdmin找不到它的专属布局文件，就会默认回退使用Rails的application.html.erb全局布局，但ActiveAdmin自身的视图模板已经包含了完整的页面结构（页眉、主体、页脚组件），两层布局套在一起，就出现了你看到的重复内容。

下面给你几个针对性的解决思路，按从易到难排序：

1. 恢复专属布局，给自定义动作单独指定布局 #

最简单的方案就是先把active_admin.html.erb恢复回来，然后给你的自定义控制器动作单独设置布局：

• 把app/views/layouts/active_admin.html.erb恢复到原来的位置（如果是删除了就从版本控制里拉回来，或者重新生成一份默认的）
• 在你的自定义控制器中，针对需要的动作指定使用application布局：

  class YourCustomAdminController < ApplicationController
    def your_custom_action
      # 你的业务逻辑代码
      render layout: 'application' # 这里指定用全局布局
    end
  end
  

这样ActiveAdmin的页面继续用它自己的专属布局，自定义动作单独用全局布局，两边互不干扰，完美解决冲突。

2. 配置ActiveAdmin使用独立布局，避免 fallback 到全局布局 #

如果你不想保留默认的active_admin.html.erb，可以在ActiveAdmin的初始化配置里明确指定布局，防止它自动使用全局布局：

• 打开config/initializers/active_admin.rb，添加或修改以下配置：

  ActiveAdmin.setup do |config|
    # 其他已有的配置...
    # 指定ActiveAdmin使用自定义布局，比如新建一个active_admin_custom.html.erb
    config.layout = 'active_admin_custom'
    # 极端情况：如果不需要外层布局，也可以直接设置为false，让ActiveAdmin只渲染自身内容
    # config.layout = false
  end
  

如果指定了自定义布局文件，记得在app/views/layouts下创建对应的文件，确保它只包含ActiveAdmin需要的页面结构，不要和全局布局的内容重复。

3. 修改全局布局，排除ActiveAdmin页面的重复渲染 #

如果想彻底统一布局逻辑，可以在application.html.erb里添加判断，不给ActiveAdmin页面渲染全局的页眉、页脚：

# app/views/layouts/application.html.erb
<!DOCTYPE html>
<html>
<head>
  <!-- 全局头部资源 -->
</head>
<body>
  <!-- 只给非ActiveAdmin页面渲染全局页眉 -->
  <% unless controller.class.ancestors.include?(ActiveAdmin::BaseController) %>
    <header>你的全局页眉内容</header>
  <% end %>

  <%= yield %>

  <!-- 只给非ActiveAdmin页面渲染全局页脚 -->
  <% unless controller.class.ancestors.include?(ActiveAdmin::BaseController) %>
    <footer>你的全局页脚内容</footer>
  <% end %>
</body>
</html>

这样当访问ActiveAdmin页面时，全局布局里的页眉页脚就不会渲染，避免和ActiveAdmin自身的结构重复叠加。

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