Rails通过SparkPost发送邮件Content-Type无法保持设置的问题

你遇到的这个问题确实挺棘手——明明在Rails端已经通过两种方式设置了text/html的Content-Type，开发环境用MailCatcher测试正常，生产日志也显示发送的邮件头是正确的text/html; charset=UTF-8，但通过SparkPost投递后，收件方（Gmail、Office.com）收到的邮件却被转成了text/plain。结合你提到应用里其他邮件发送器没这个问题，大概率问题出在SparkPost的平台配置或内容处理逻辑上，下面给你几个具体的排查和解决方向：

1. 检查SparkPost的模板与内容转换设置 #

SparkPost自身可能会对邮件内容做自动调整，尤其是你用到平台模板或开启了内容优化选项时：

• 登录SparkPost控制台，确认这个邮件发送器是否绑定了默认纯文本模板，如果模板类型是纯文本，会直接覆盖你在Rails里设置的Content-Type；
• 查看平台的Content Conversion相关配置，有些选项会自动把HTML内容转成纯文本，或者强制用纯文本格式投递。

2. 确认邮件内容包含有效HTML结构 #

有时候哪怕设置了Content-Type为text/html，如果邮件内容本身没有任何HTML标签（比如只是纯文本内容），SparkPost可能会自动降级为text/plain：

• 检查你的ActionMailer视图文件（比如xxx.html.erb），确保有完整的HTML结构，比如至少包含<html>、<body>标签，而不是纯文本内容；
• 查看生产日志里的完整邮件内容，确认HTML部分是否正确生成。

3. 在SparkPost层面强制指定Content-Type #

可以尝试绕过Rails的设置，直接在SparkPost的发送逻辑里强制指定内容类型：

• 如果用的是Rails的SparkPost gem，可在邮件中添加SparkPost自定义头：

  headers['X-SparkPost-Content-Type'] = 'text/html'
  

• 或者在SparkPost的发送请求参数里，直接设置content_type为text/html，覆盖平台的自动判断逻辑。

4. 排查SparkPost的路由与收件人规则 #

部分情况下，SparkPost针对特定收件域名的路由规则或投递设置会修改邮件格式：

• 查看是否有针对Gmail、Office.com的特殊路由规则，这类规则可能会强制转换邮件内容格式；
• 检查平台的Deliverability相关配置，是否开启了针对特定邮箱的内容适配选项。

5. 对比正常发送的邮件配置 #

既然你说应用里其他邮件发送器没问题，把有问题的发送器配置和正常的做对比：

• 检查是否用了不同的SparkPost API密钥、发送域；
• 对比两者的ActionMailer配置，比如是否有额外的头信息、模板设置差异。

另外，你可以直接用SparkPost的API发送一封测试HTML邮件（绕过Rails），看看是否还会出现Content-Type被转换的问题，这样能快速定位是Rails端还是SparkPost平台的问题。

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