含iCal附件的Multipart邮件结构异常问题排查与修复咨询

问题1：代码操作错误点 #

你当前代码的问题在于先添加附件，再调用mail方法。ActionMailer的mail方法会自动根据你提供的text/html视图生成multipart/alternative块，但提前调用mail.attachments会触发Mail gem先单独渲染text和html视图作为独立部分，之后mail方法又生成了包含这两部分的multipart/alternative块，最终导致内容重复、结构混乱。

问题2：强制构建期望的邮件结构 #

可以通过两种方式手动构造目标邮件结构：

方式1：调整代码顺序 #

把mail方法的调用提前，再添加附件，让ActionMailer自动处理层级：

def created(registration)
  ...

  # 先调用mail方法生成基础的multipart/alternative结构
  mail_message = mail(to: @recipient.email, subject: "[20 Liters] You registered for a filter build on #{@event.mailer_time}")

  # 再添加iCal附件
  cal = Icalendar::Calendar.new
  cal.event do |e|
    e.dtstart = @event.start_time
    e.dtend = @event.end_time
    e.organizer = 'mailto:filterbuilds@20liters.org'
    e.attendee = @recipient
    e.location = @location.addr_one_liner
    e.summary = @summary
    e.description = @description
  end
  cal.append_custom_property('METHOD', 'REQUEST')
  mail_message.attachments[@attachment_title] = { mime_type: 'text/calendar', content: cal.to_ical }

  mail_message
end

方式2：手动构建邮件层级 #

如果方式1不生效，可以直接手动创建邮件容器，明确指定各部分的层级关系：

def created(registration)
  ...

  # 渲染text和html内容
  text_content = render_to_string(template: 'registration_mailer/created.text.erb')
  html_content = render_to_string(template: 'registration_mailer/created.html.erb')

  # 创建multipart/alternative块，包含text和html内容
  alternative_part = Mail::Part.new do
    content_type 'multipart/alternative'
    part do
      content_type 'text/plain; charset=UTF-8'
      body text_content
    end
    part do
      content_type 'text/html; charset=UTF-8'
      body html_content
    end
  end

  # 创建iCal附件部分
  cal = Icalendar::Calendar.new
  cal.event do |e|
    e.dtstart = @event.start_time
    e.dtend = @event.end_time
    e.organizer = 'mailto:filterbuilds@20liters.org'
    e.attendee = @recipient
    e.location = @location.addr_one_liner
    e.summary = @summary
    e.description = @description
  end
  cal.append_custom_property('METHOD', 'REQUEST')
  cal_part = Mail::Part.new do
    content_type 'text/calendar; charset=UTF-8'
    filename @attachment_title
    body cal.to_ical
  end

  # 创建顶级multipart/mixed容器，整合所有部分
  mail_message = Mail.new do
    to @recipient.email
    subject "[20 Liters] You registered for a filter build on #{@event.mailer_time}"
    content_type 'multipart/mixed'
    add_part alternative_part
    add_part cal_part
  end

  mail_message
end

两种方式都能生成你期望的正确邮件结构：

1. Content-Type: multipart/mixed
    A. Content-Type: multipart/alternative
        i. Content-Type: text/plain
        ii. Content-Type: text/html
    B. Content-Type: text/calendar

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