Rails ActionMailer Quoted Printable编码致邮件渲染异常求助

核心问题原因 #

ActionMailer依赖的Mail gem会自动检测邮件内容长度，当HTML内容超过7bit编码的每行字符限制（默认1000字符）时，会自动转成quoted-printable编码，而部分邮箱客户端或Graph API对这种编码的解析存在兼容性问题，导致渲染异常；而用binary编码时，附件的编码逻辑会冲突，导致附件无法正常工作。

可行解决方案 #

1. 强制锁定7bit编码并手动处理内容换行

直接在邮件构建时强制设置编码，同时手动拆分HTML内容到符合7bit规范的长度（每行不超过998字符，留2字符给换行符），避免Mail gem自动转换编码：

def send_html_email(recipient, html_content)
  # 手动拆分HTML内容，每行最多998字符，用CRLF换行
  formatted_html = html_content.gsub(/(.{1,998})(?=\S|$)/, "\\1\r\n")
  
  mail(to: recipient, subject: "你的邮件主题") do |format|
    format.html { render html: formatted_html.html_safe }
  end

  # 强制覆盖编码设置，禁用自动转换
  mail.content_transfer_encoding = '7bit'
  mail.body.raw_source = formatted_html
end

2. 改用Base64编码（推荐）

Base64编码是邮箱系统和Graph API支持最稳定的编码方式，不会受内容长度影响，同时完全兼容附件处理，不需要手动调整内容：
在你的ActionMailer基类中添加全局设置：

class ApplicationMailer < ActionMailer::Base
  before_action :use_base64_encoding

  private
  def use_base64_encoding
    mail.content_transfer_encoding = 'base64'
  end
end

这样所有邮件都会用Base64编码，既不会触发自动转quoted-printable的逻辑，附件也能正常生成和解析。

3. 手动构造MIME字符串绕开ActionMailer自动处理

如果上面的方法都不生效，可以直接手动构建符合要求的MIME邮件内容，完全控制编码和格式：

def build_custom_mime_email(recipient, html_content, attachments = [])
  # 构建HTML内容部分，强制7bit编码
  html_part = Mail::Part.new do
    content_type 'text/html; charset=UTF-8'
    content_transfer_encoding '7bit'
    body html_content.gsub(/(.{1,998})(?=\S|$)/, "\\1\r\n")
  end

  # 构建完整邮件
  mail = Mail.new do
    to recipient
    subject "你的邮件主题"
    add_part html_part
  end

  # 添加附件，用Base64编码保证兼容性
  attachments.each do |file|
    mail.add_file(filename: file[:name], content: file[:content]) do |part|
      part.content_transfer_encoding = 'base64'
    end
  end

  # 生成最终MIME字符串
  mail.to_s
end

将这个方法生成的字符串直接传给Microsoft Graph API的sendMail接口即可。

4. 校验MIME格式细节

确保邮件的换行符用\r\n（CRLF）而不是\n（LF），Content-Type头部明确指定charset=UTF-8，这些细节会影响邮箱客户端的渲染效果。

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