Kayako升级SwiftMailer解决特殊字符问题后出现附件编码异常

问题背景 #

我在使用Kayako Help Desk时碰到了一个棘手的问题：只要发送的邮件名称或主题里包含特殊字符，系统就会持续报错，完全发不出去。

排查与核心原因定位 #

经过一番排查，终于锁定了问题根源——项目里用的SwiftMailer 4.1.3版本对特殊字符的编码处理存在缺陷，没法正确解析这类内容，导致发送流程中断报错。

修复特殊字符报错的操作步骤 #

为了解决这个问题，我执行了以下两步操作：

• 把SwiftMailer从4.1.3版本升级到了5.4.9版本，这个版本对特殊字符的编码逻辑做了优化，能更好地处理这类场景。
• 升级过程中遇到了类名冲突：系统里已经存在一个Swift类，和SwiftMailer原生的Swift_前缀类名冲突了。于是我把SwiftMailer所有文件里的Swift_前缀统一改成了SwiftMailer_，彻底解决了命名冲突问题。

当前状态与遗留问题 #

• 好消息是，含特殊字符的名称/主题邮件发送问题已经彻底解决，现在这类邮件能正常发送了。
• 但还有个遗留问题没搞定：带有附件的邮件，其正文在Outlook客户端里会出现编码异常，显示内容乱码或者格式错乱，其他客户端暂时没发现这个问题。

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