使用javax.mail.Authenticator时Base64编码认证失败问题排查

我之前也碰到过类似的坑，结合JavaMail的工作机制，给你梳理几个大概率的问题点：

• 重复编码问题：javax.mail的Authenticator默认会根据邮件服务器的认证协议（比如PLAIN、LOGIN）自动对用户名和密码做Base64编码。如果你手动先编码了一次再传给Authenticator，服务器收到的其实是Base64编码两次的字符串，自然会判定账号密码错误。
  解决：直接传入原始的账号和密码，让JavaMail自动处理编码流程。

• Base64编码格式不匹配：不同Base64实现有差异，比如Java的Base64.getMimeEncoder()会自动插入换行符（每76个字符一行），但很多邮件服务器不接受带换行的Base64字符串；还有些场景会用到URL安全的Base64（替换+和/为-和_），如果服务器要求标准Base64也会出错。
  解决：使用标准无换行的Base64编码，比如Base64.getEncoder().encodeToString(original.getBytes(StandardCharsets.UTF_8))，确保编码后的字符串干净无多余字符。

• 字符集不一致：你编码账号密码时用的字符集（比如GBK）和服务器端解析用的字符集（通常是UTF-8）不匹配，会导致编码后的字符串完全不同。
  解决：明确指定UTF-8字符集进行编码，比如originalString.getBytes(StandardCharsets.UTF_8)，别依赖系统默认字符集。

• 账号格式错误：有些服务器要求账号是完整邮箱地址（比如user@example.com），但你可能只编码了用户名部分（user）；或者编码前的字符串不小心混入了空格、制表符等多余字符。
  解决：核对服务器要求的账号格式，确保编码前的字符串完全符合要求，没有冗余内容。

如果以上都排查过还是有问题，可以开启JavaMail的调试模式，看看实际发送的认证字符串是什么：

props.put("mail.debug", "true");

这样能直观看到客户端和服务器的认证交互细节，更容易定位问题。

内容的提问来源于stack exchange，提问作者Tuấn Phạm