如何在控制器上下文外实现Rails局部视图渲染？

要解决模板中render方法未定义的问题，核心是让你的ERB渲染上下文具备Rails原生的视图渲染能力，直接复用ActionView的渲染机制即可，不用自己实现partial渲染逻辑。

实现步骤 #

1. 构建带渲染能力的上下文类

直接继承Rails的ActionView::Base——这是Rails视图渲染的底层类，自带render方法，能识别partial模板（下划线开头的文件），完美匹配你现有模板的调用逻辑。

class PdfRenderContext < ActionView::Base
  def initialize(variables = {})
    # 设置模板查找路径，根据你的模板实际存放位置调整
    # 示例：模板放在 app/views/pdf_reports 目录下
    super(Rails.root.join('app', 'views', 'pdf_reports'))
    
    # 将需要传递给模板的变量注入上下文
    variables.each do |key, value|
      instance_variable_set("@#{key}", value)
    end

    # 按需引入辅助方法（如果模板里用到asset_tag、路由helper等）
    include Rails.application.routes.url_helpers
    include ActionView::Helpers::AssetUrlHelper
    include ActionView::Helpers::TagHelper
  end
end

2. 用上下文渲染模板并生成PDF

通过实例化上述上下文类，直接调用其render方法渲染你的layout.html.erb（里面的render '_header'、render '_footer'会被自动解析），再把渲染后的HTML传给Gotenberg。

# 1. 准备模板所需的变量
template_vars = {
  report_title: "2024年Q1销售报表",
  generated_at: Time.current,
  data: SalesReportService.quarterly_data
}

# 2. 初始化渲染上下文
render_context = PdfRenderContext.new(template_vars)

# 3. 渲染主模板（layout里已经包含对header、footer的partial调用）
rendered_html = render_context.render(template: "layout")

# 4. 传给Gotenberg生成PDF
# 这里替换成你现有Gotenberg的调用逻辑，比如HTTP请求或客户端调用
GotenbergClient.new.convert(html: rendered_html, output_path: "/tmp/report.pdf")

关键说明 #

• 模板路径配置：super方法传入的路径是Rails查找模板的根目录，确保你的_header.html.erb、_footer.html.erb、layout.html.erb都在这个目录下。
• 变量传递：通过instance_variable_set把变量转为上下文的实例变量，模板里可以直接用@report_title这类写法。
• 辅助方法支持：如果模板里用到image_tag、link_to等helper，需要手动引入对应的模块，否则会报错。

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