如何在Rails api_only单体核心下为CMS引擎恢复全栈环境？

我之前碰到过完全一致的场景——核心业务用api_only模式跑API，CMS引擎却需要完整的全栈环境，官方文档里的钩子确实有时候不太顶用，这里给你一套经过实际验证的解决方案：

1. 在CMS引擎初始化文件中手动补全全栈中间件 #

config.api_only = true会自动移除Cookie、Flash、Action View相关的中间件，我们要在CMS引擎加载时把这些关键组件加回来。打开你的CMS引擎的lib/[cms_engine_name]/engine.rb，添加以下代码：

module CmsEngine
  class Engine < ::Rails::Engine
    isolate_namespace CmsEngine

    # 在Rails构建中间件栈前插入全栈所需组件
    initializer "cms_engine.add_full_stack_middleware", before: :build_middleware_stack do |app|
      # 补全Cookie、Session、Flash支持
      app.middleware.use ActionDispatch::Cookies
      app.middleware.use ActionDispatch::Session::CookieStore, Rails.application.config.session_options
      app.middleware.use ActionDispatch::Flash

      # 补全Action View模板渲染中间件
      app.middleware.use ActionView::Middleware::TemplateRenderer
      app.middleware.use ActionView::Middleware::StreamingTemplateRenderer
    end

    # 手动启用Action View（api_only默认禁用）
    config.action_view.enabled = true
  end
end

2. 为CMS引擎单独配置生成器规则 #

核心的config.generators.api_only = true不会覆盖引擎的独立配置，继续在engine.rb里添加生成器设置：

config.generators do |g|
  g.api_only false
  g.assets true
  g.helper true
  g.template_engine :erb # 换成你实际用的模板引擎，比如slim或haml
end

这样你在CMS引擎里生成控制器、资源时，会自动创建视图模板、helper等全栈文件，而不是API模式下的极简结构。

3. 为CMS引擎创建独立的基础控制器 #

核心的ApplicationController大概率继承自ActionController::API，不适合CMS的全栈需求。给CMS引擎单独建一个基础控制器：

在app/controllers/cms_engine/base_controller.rb中：

module CmsEngine
  class BaseController < ActionController::Base
    protect_from_forgery with: :exception # 启用CSRF保护，全栈环境必备
  end
end

之后所有CMS引擎的控制器都继承这个BaseController，而非核心的ApplicationController。

4. 验证中间件加载状态 #

启动服务器后，在控制台运行Rails.application.middleware，检查输出里是否包含刚才添加的中间件。如果还有缺失，可以对照Rails全栈默认的中间件列表补充（比如Rack::MethodOverride、ActionDispatch::ContentSecurityPolicy::Middleware等）。

为什么之前的钩子无效？ #

很多人尝试用config.after_initialize这类钩子，但build_middleware_stack是Rails构建中间件栈的关键节点，我们用before: :build_middleware_stack能确保中间件在栈构建前被插入，晚于这个时机的钩子可能无法改变已成型的中间件结构。

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