使用JavaMail访问需SSO登录的Outlook邮件时认证失败求助

我完全懂你现在的困扰——用JavaMail对接企业内部Outlook时，反复碰到javax.mail.AuthenticationFailedException: Logon failure: unknown user name or bad password.，但Gmail却能正常访问，显然问题就卡在Outlook那套需要重复输入账号密码的SSO适配上。

先给你拆解下核心原因：企业级Outlook的SSO大多依赖NTLM或Kerberos这类域身份验证协议，而非普通邮箱的用户名密码认证，JavaMail默认的认证逻辑根本适配不了这种"两次输入"的SSO流程，尤其是当你的邮箱绑定了公司AD域的时候。

下面是针对性的解决方案，按优先级排序：

• 启用NTLM认证适配域环境
  大部分企业内部Outlook都用NTLM做SSO，你需要在JavaMail配置里明确指定认证机制为NTLM，同时补充公司域信息（如果有的话）。示例代码：

  Properties props = new Properties();
  props.setProperty("mail.store.protocol", "imap");
  props.setProperty("mail.imap.host", "outlook.office365.com"); // 替换成你们企业内部IMAP地址
  props.setProperty("mail.imap.port", "993");
  props.setProperty("mail.imap.ssl.enable", "true");
  // 开启NTLM认证支持
  props.setProperty("mail.imap.auth.mechanisms", "NTLM");
  // 填写公司域名称（比如你的账号是xxx@company.com，域就是COMPANY）
  props.setProperty("mail.imap.ntlm.domain", "YOUR_COMPANY_DOMAIN");
  
  Session session = Session.getInstance(props, new Authenticator() {
      @Override
      protected PasswordAuthentication getPasswordAuthentication() {
          // 这里输入你的完整邮箱和密码
          return new PasswordAuthentication("your-email@company.com", "your-password");
      }
  });
  
  // 后续Store连接、邮件读取代码...
  

  要是你们用的是Exchange服务器而非普通IMAP，建议直接用Exchange专用协议，适配性更好。

• 改用Exchange专用JavaMail扩展
  针对企业Exchange环境的SSO，普通IMAP/POP3协议的适配性有限，推荐使用com.sun.mail:exchange这个专用依赖。步骤如下：
  先添加Maven依赖（用Gradle的话对应调整）：

  <dependency>
      <groupId>com.sun.mail</groupId>
      <artifactId>exchange</artifactId>
      <version>1.6.7</version> <!-- 建议用最新稳定版 -->
  </dependency>
  

  然后配置代码：

  Properties props = new Properties();
  props.setProperty("mail.store.protocol", "exchange");
  props.setProperty("mail.exchange.host", "your-company-exchange-server.com");
  props.setProperty("mail.exchange.username", "your-email@company.com");
  props.setProperty("mail.exchange.password", "your-password");
  // 开启NTLM认证
  props.setProperty("mail.exchange.auth.type", "NTLM");
  props.setProperty("mail.exchange.ntlm.domain", "YOUR_COMPANY_DOMAIN");
  
  Session session = Session.getInstance(props);
  Store store = session.getStore("exchange");
  store.connect();
  

  这种方式对Exchange的SSO流程支持更原生，能很好处理"两次输入账号密码"的场景。

• 排查是否需要OAuth2认证
  如果你们企业用的是Office 365版Outlook，可能已经改用OAuth2作为SSO方式，这时普通密码认证必然失败。你需要先通过企业的SSO授权流程获取访问令牌，再配置JavaMail使用OAuth2：

  Properties props = new Properties();
  props.setProperty("mail.store.protocol", "imap");
  props.setProperty("mail.imap.host", "outlook.office365.com");
  props.setProperty("mail.imap.port", "993");
  props.setProperty("mail.imap.ssl.enable", "true");
  props.setProperty("mail.imap.auth.mechanisms", "XOAUTH2");
  
  Session session = Session.getInstance(props);
  Store store = session.getStore("imap");
  // 用OAuth2访问令牌连接
  store.connect("outlook.office365.com", "your-email@company.com", "your-oauth2-access-token");
  

  令牌可以通过Microsoft Graph API的授权码流程获取，具体需要跟企业IT确认授权规则。

最后给你几个排查小技巧：

1. 先确认账号密码能在Outlook桌面/网页端正常登录，注意大小写、特殊字符有没有输错；
2. 如果企业开了多因素认证（MFA），哪怕是SSO场景，普通密码也会失效，必须用OAuth2或企业允许的应用专用密码；
3. 开启JavaMail调试日志：在Session配置里加props.setProperty("mail.debug", "true");，能看到详细的协议交互过程，方便定位哪一步认证失败。

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