Rails中ActionMailer附加Wicked PDF时样式无法加载的问题

以下是几个可行的解决方向，按优先级尝试：

1. 直接嵌入CSS内容（最可靠） #

替换布局中的wicked_pdf_stylesheet_link_tag为wicked_pdf_stylesheet_content_tag，直接把CSS内容嵌入到HTML里，避免路径解析问题：

# layouts/pdf/base.erb
= wicked_pdf_stylesheet_content_tag "pdf"

这个方法跳过了外部资源加载环节，直接把编译后的CSS插入到HTML头部，确保wkhtmltopdf能直接读取样式。

2. 确保PDF样式文件被预编译 #

生产环境中，Rails不会自动预编译非标准asset文件，需要手动添加到预编译列表：

# config/initializers/assets.rb
Rails.application.config.assets.precompile += %w( pdf.scss )

添加后重新执行预编译命令（生产环境执行rails assets:precompile），确保pdf.css能被正确生成到public/assets目录。

3. 显式传递本地文件访问参数 #

虽然配置文件里设置了enable_local_file_access: true，但在邮件生成PDF时可能未生效，尝试在render_to_string_with_wicked_pdf中显式传递该参数：

def render_pdf_template
  render_to_string_with_wicked_pdf(
    template: 'orders/pdf/show_pdf',
    layout: 'pdf/base',
    formats: [:pdf],
    pdf: @order.number,
    enable_local_file_access: true # 显式添加
  )
end

4. 使用绝对路径引用样式文件 #

如果坚持使用link标签，生成绝对路径指向本地asset文件：

# layouts/pdf/base.erb
= wicked_pdf_stylesheet_link_tag "file://#{Rails.root.join('public', 'assets', 'pdf.css')}", media: 'all'

注意要替换成实际的asset文件路径，生产环境下需确保文件存在且路径正确。

内容的提问来源于stack exchange，提问作者Samuel D.