龙空技术网

关于JavaMail,我遇上的那些史前巨坑...(建议收藏)

是程序媛不是程序猿 73

前言:

目前小伙伴们对“java outlook”大约比较关心,看官们都想要分析一些“java outlook”的相关文章。那么小编也在网上网罗了一些关于“java outlook””的相关内容,希望同学们能喜欢,小伙伴们快快来学习一下吧!

说到乱码,很多人都遇到过,“哎呀,你这个编码是不是UTF-8!”,“你这个会不会操作系统不一致导致的?”,“肯定是两边编码不一致”。不过我们今天说的问题,还真不是这个问题导致的。

问题

用JavaMail 发邮件,带上附件,闪电邮客户端收到后,附件名有时乱码,有时非乱码。查看Java端代码:

String name = MimeUtility.encodeText(name, null) + ".xlsx";		messageBodyPart.setFileName(name);12

貌似已经做过编码转换了。

令人感到奇怪的是,稍微改变附件名,乱码就消失了。

发现

收集各种信息的时候,突然发现 Ubuntu的小伙伴 在 ThunderBird下收邮件表示没有异常,Mac党表示自带的邮件工具收件也没有问题。那是不是操作系统字符编码问题呢? 可是遗憾的是,在corp 邮箱网页版上,依旧是乱码。 这时候初步怀疑是邮件系统不兼容的问题了,来看邮件源码:

Content-Type: application/octet-stream; 	name*0="=?utf-8?B?6L+Q6JCl5ZGo5oql576O5a655b2p5aaG5YmN5Y+w5Y2V5ZOB6Z"; 	name*1="SA5ZSu?=.xls"Content-Transfer-Encoding: base64Content-Disposition: attachment; 	filename*0="=?utf-8?B?6L+Q6JCl5ZGo5oql576O5a655b2p5aaG5YmN5Y+w5Y2V5ZOB6Z"; 	filename*1="SA5ZSu?=.xls"1234567

这串就是 有些系统乱码有些系统 正常显示的 邮件源码。。

对比在闪电邮上的非乱码邮件:

Content-Type: application/octet-stream; name="=?utf-8?B?5rWL6K+V?=.xlsx"Content-Transfer-Encoding: base64Content-Disposition: attachment; filename="=?utf-8?B?5rWL6K+V?=.xlsx"123

filename0,filename1 和 filename 的区别,猜测也许就是闪电邮这个客户端不支持这种filename0,filename1 协议导致的问题。

分析

有了以上的想法,就开始来看源码。

MimeBodyPart 这个类中的 setFileName 方法 用到一个 ParameterList 在ParameterList 的 toString 类中找到下面一段:

if (v instanceof MultiValue) {		// ....			ns = name + i + "*";		//...		}	    } else if (v instanceof Value) {		/// ...	    } else {				if (value.length() > 60 &&				splitLongParameters && encodeParameters) {		    int seg = 0;		    name += "*";		    /// ....		}123456789101112131415

这个类在邮件附件属于 MultiValue 会把 名字用name + i 隔开 ,在名字大于 60个字符的时候也会主动截断,这也就是 javamail 中 附件的命名规则,名字太长会被截断~~!

中文在base64 加密后,超过60个字符那是妥妥的有可能。这种截断文件名的模式在某些客户端,比如闪电邮中,并不能很好的支持。

解决

解决就很容易了, 代码里有 splitLongParameters 这个参数, 观察了下 对应于一个环境变量,如果想不截断文件名,只要在程序运行之初加上:

System.setProperty("mail.mime.splitlongparameters","false");1

就可以了。测试,解决。。。

另外由于发现了这个问题,google到了 java mail 的完整配置,

JAVA Mail System 环境变量 包括是否自动编码等配置,曾经没怎么关注过。

总结

邮件系统的不兼容是导致这个错误的根本原因,还真不是编码问题,所以有的时候看问题还不能那么想当然。这个测试未必能测出,毕竟要满足名字足够长这个条件。在这里分享这个问题,以免JAVA党同学重复踩坑

看到这里的小伙伴,如果你喜欢这篇文章的话,别忘了转发、收藏、留言互动!

如果对文章有任何问题,欢迎在留言区和我交流~

最近我新整理了一些资料,包含面经分享、模拟试题、和视频干货,如果你需要的话,欢迎私信我!

标签: #java outlook