如何解决Rails确认邮件options哈希传递额外参数仅显示头信息问题？

嘿，我之前也碰到过类似的坑，咱们一步步来排查解决：

1. 先看是不是Devise邮件器的参数过滤问题 #

如果你是用Devise自带的确认邮件功能（比如调用send_confirmation_instructions时传额外参数），默认情况下Devise的邮件器只会提取subject、from这类标准邮件头参数，自定义参数不会自动传到邮件器实例里。这时候得改改Devise的邮件器，让它接住这些额外参数。

具体操作： #

如果你已经生成了自定义的Devise邮件器（用rails generate devise:mailer命令），就在邮件器的confirmation_instructions方法里把自定义参数存成实例变量：

# app/mailers/devise_mailer.rb
class DeviseMailer < Devise::Mailer
  def confirmation_instructions(record, token, opts = {})
    # 把自定义参数捞出来存成实例变量，模板里就能直接用了
    @custom_data = opts[:custom_data]
    # 别忘调用父类方法处理标准的邮件头逻辑
    super
  end
end

这样在邮件模板（比如app/views/devise/mailer/confirmation_instructions.html.erb）里，直接写<%= @custom_data %>就能拿到值了。

2. 自定义邮件器的参数传递误区 #

如果是你自己写的完全独立的邮件器，那问题大概率出在参数传递或者方法定义上。比如你可能在调用邮件器时传了参数，但邮件器方法里没处理：

错误示范（参数直接丢了）： #

# 控制器里调用，传了custom_info但邮件器没理它
UserMailer.confirmation_email(user, {subject: "确认邮件", custom_info: "test"}).deliver_now

# 邮件器方法只抓了subject，完全没管custom_info
class UserMailer < ApplicationMailer
  def confirmation_email(user, opts = {})
    @user = user
    mail(subject: opts[:subject])
  end
end

正确的打开方式： #

把自定义参数单独存成实例变量，这样模板就能访问到：

class UserMailer < ApplicationMailer
  def confirmation_email(user, opts = {})
    @user = user
    # 把自定义参数存起来
    @custom_info = opts[:custom_info]
    # 处理邮件头，剩下的业务参数已经在实例变量里了
    mail(to: user.email, subject: opts[:subject] || "默认确认主题")
  end
end

3. 别在mail方法里瞎折腾自定义参数 #

要注意：mail方法的参数是用来设置邮件的各种头信息（to、from、subject这些），自定义的业务参数别往这里塞，应该通过实例变量传递给模板。比如你要是只在mail里传subject和from，那其他参数自然就丢了。

4. 调试小妙招 #

要是还是找不到问题，直接在邮件器方法里加个打印，看看接收到的opts到底是什么样的：

def confirmation_instructions(record, token, opts = {})
  puts "收到的opts哈希：#{opts.inspect}" # 控制台会输出完整的opts内容
  # ...其他代码
end

这样就能立刻搞清楚：是参数根本没传进来，还是邮件器没处理好。

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