Javamail如何连接启用多因素认证的outlook.com邮箱？

失败原因说明 #

开启多因素认证的outlook.com邮箱默认禁止传统密码认证方式登录IMAP/POP/SMTP服务，必须使用OAuth2.0的XOAUTH2认证机制，原密码登录逻辑和Gmail专属的OAuth配置无法直接复用。

前置凭证获取（需要先完成） #

你需要先在Azure AD平台注册应用获取以下3个核心凭证，无需额外付费：

• 客户端ID（client_id）
• 客户端密钥（client_secret）
• 授权后的访问令牌（access_token）

步骤1：Azure AD应用注册 #

1. 登录Azure门户，进入「应用注册」服务，新建应用注册
2. 名称自定义，支持账户类型选择「个人Microsoft账户和工作或学校账户」，重定向URI填写https://login.microsoftonline.com/common/oauth2/nativeclient
3. 注册完成后直接在概览页获取应用程序(客户端) ID，即client_id
4. 进入「证书和密码」页面，新建客户端密码，保存生成的密码字符串，即client_secret（仅展示一次，需妥善保存）
5. 进入「API权限」页面，添加Microsoft Graph的委托权限，勾选IMAP.AccessAsUser.All、POP.AccessAsUser.All、SMTP.Send，完成后授予同意权限

步骤2：获取访问令牌 #

推荐使用微软官方MSAL4J库处理OAuth授权流程，无需手动拼接授权请求，会自动处理令牌刷新、有效期维护逻辑，避免1小时令牌过期问题。

JavaMail对接代码实现 #

依赖引入（Maven为例） #

<!-- JavaMail 依赖 -->
<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>
<!-- MSAL4J 依赖 -->
<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>msal4j</artifactId>
    <version>1.13.8</version>
</dependency>

访问令牌获取示例 #

import com.microsoft.aad.msal4j.*;
import java.util.Collections;
import java.util.Set;

public class MsalTokenProvider {
    private static final String CLIENT_ID = "你注册的client_id";
    private static final String CLIENT_SECRET = "你生成的client_secret";
    private static final Set<String> SCOPE = Collections.singleton("https://outlook.office.com/IMAP.AccessAsUser.All");
    private static final String REDIRECT_URI = "https://login.microsoftonline.com/common/oauth2/nativeclient";

    public static String getAccessToken() throws Exception {
        PublicClientApplication pca = PublicClientApplication.builder(CLIENT_ID)
                .authority("https://login.microsoftonline.com/common")
                .build();
        
        // 首次授权会弹出浏览器页面让用户登录Outlook账号完成授权，后续会自动缓存刷新令牌
        InteractiveRequestParameters parameters = InteractiveRequestParameters
                .builder(new java.net.URI(REDIRECT_URI))
                .scopes(SCOPE)
                .build();
        
        IAuthenticationResult result = pca.acquireToken(parameters).get();
        return result.accessToken();
    }
}

正确的IMAP连接配置 #

import javax.mail.Session;
import javax.mail.Store;
import java.util.Properties;

public class OutlookImapClient {
    public static void connectImap(String username, String accessToken) throws Exception {
        Properties props = new Properties();
        // Outlook IMAP基础配置
        props.put("mail.store.protocol", "imap");
        props.put("mail.imap.host", "imap-mail.outlook.com");
        props.put("mail.imap.port", "993");
        // SSL配置
        props.put("mail.imap.ssl.enable", "true");
        // XOAUTH2认证配置
        props.put("mail.imap.sasl.enable", "true");
        props.put("mail.imap.sasl.mechanisms", "XOAUTH2");
        props.put("mail.imap.auth.login.disable", "true");
        props.put("mail.imap.auth.plain.disable", "true");

        Session session = Session.getInstance(props);
        session.setDebug(true); // 开启调试可排查连接问题
        Store store = session.getStore("imap");
        // 注意第三个参数传入获取到的access_token，不是邮箱密码
        store.connect("imap-mail.outlook.com", username, accessToken);
        
        // 后续操作和原有逻辑一致，比如读取收件箱
        // IMAPFolder inbox = (IMAPFolder) store.getFolder("INBOX");
        // inbox.open(Folder.READ_ONLY);
    }
}

注意事项 #

• 如果你使用POP3或者SMTP服务，仅需要调整对应权限和配置前缀即可，比如将mail.imap开头的配置换成mail.pop3或者mail.smtp
• 令牌有效期默认为1小时，使用MSAL4J的缓存机制可以自动刷新令牌，无需重复用户授权
• 个人Outlook账号不需要管理员权限，注册应用后自己完成授权即可使用

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