Office 365 共享邮箱IMAP连接故障排查与现代认证解决方案

import javax.mail.*;
import java.util.Properties;

public class EmailTest {

    public static void main(String[] args) throws MessagingException {

        Properties props = new Properties();
        props.put("mail.imaps.starttls.enable", "true");
        props.put("mail.imaps.ssl.enable", "true");
        // 以下属性尝试禁用一些认证机制，但未能解决根本问题
        props.put("mail.imaps.auth.plain.disable", "true");
        props.put("mail.imaps.auth.ntlm.disable", "true");
        props.put("mail.imaps.auth.gssapi.disable", "true");

        props.put("mail.imaps.host", "outlook.office365.com");
        props.put("mail.imaps.port", 993);

        Session session = Session.getInstance(props);
        session.setDebug(true); // 开启调试模式查看详细日志
        Store _store = session.getStore("imaps");

        // 尝试使用用户名和密码连接共享邮箱
        // 注意：共享邮箱的用户名通常是拥有者邮箱地址共享邮箱别名
        _store.connect("outlook.office365.com", 993, "owner@example.com\sharedemail", "password");

        Folder inbox = _store.getFolder("INBOX");
        // inbox.open(Folder.READ_ONLY); // 后续操作，如果连接成功
        int messageCount = inbox.getMessageCount();
        System.out.println(messageCount);
    }
}

DEBUG IMAPS: AUTH: PLAIN
DEBUG IMAPS: AUTH: XOAUTH2
DEBUG IMAPS: protocolConnect login, host=outlook.office365.com, owner@example.comsharedemail, password=<non-null>
DEBUG IMAPS: LOGIN command trace suppressed
DEBUG IMAPS: LOGIN command result: A1 NO LOGIN failed.
Exception in thread "main" javax.mail.AuthenticationFailedException: LOGIN failed.
    at com.sun.mail.imap.IMAPStore.protocolConnect(IMAPStore.java:661)

// 假设您已通过某个OAuth 2.0流（如ROPC, 客户端凭据, 或授权码+PKCE）
// 成功从Azure AD获取了一个有效的访问令牌。
// 这一步通常涉及使用MSAL库或直接HTTP请求到Azure AD的认证端点。

// String tenantId = "YOUR_TENANT_ID"; // 您的Azure AD租户ID
// String clientId = "YOUR_APPLICATION_CLIENT_ID"; // 您的应用程序客户端ID
// String clientSecret = "YOUR_APPLICATION_CLIENT_SECRET"; // 您的应用程序客户端密钥 (如果适用)
// String username = "owner@example.com"; // 共享邮箱的拥有者邮箱
// String password = "YOUR_USER_PASSWORD"; // 用户密码 (仅ROPC流需要)
// String sharedMailboxAddress = "sharedemail@example.com"; // 共享邮箱地址

// String accessToken = acquireAccessToken(tenantId, clientId, clientSecret, username, password, sharedMailboxAddress);
// 实际的 acquireAccessToken 方法会非常复杂，取决于您选择的OAuth流和库
String accessToken = "YOUR_ACQUIRED_OAUTH2_ACCESS_TOKEN"; // 这是一个占位符，需要替换为实际获取到的令牌

import javax.mail.*;
import javax.mail.internet.MimeMessage;
import java.util.Properties;

public class OAuth2EmailClient {

    public static void main(String[] args) {
        // 假设您已获取到OAuth 2.0访问令牌
        String accessToken = "YOUR_ACQUIRED_OAUTH2_ACCESS_TOKEN"; // 替换为实际获取到的令牌
        String userEmail = "owner@example.com"; // 拥有共享邮箱权限的用户邮箱
        String sharedMailboxAddress = "sharedemail@example.com"; // 共享邮箱的实际地址

        Properties props = new Properties();
        props.put("mail.imaps.host", "outlook.office365.com");
        props.put("mail.imaps.port", "993");
        props.put("mail.imaps.ssl.enable", "true");
        props.put("mail.imaps.auth.mechanisms", "XOAUTH2"); // 启用XOAUTH2认证机制
        props.put("mail.imaps.user", userEmail); // 认证用户，通常是拥有共享邮箱权限的用户

        Session session = Session.getInstance(props);
        session.setDebug(true); // 开启调试模式

        Store store = null;
        Folder inbox = null;
        try {
            store = session.getStore("imaps");
            // 使用用户邮箱和访问令牌进行连接
            // 对于共享邮箱，通常是拥有者邮箱作为用户名，令牌作为密码
            // JavaMail的connect方法会识别XOAUTH2机制并使用提供的令牌
            store.connect("outlook.office365.com", userEmail, accessToken);

            // 连接成功后，您可能需要指定共享邮箱的路径。
            // 共享邮箱通常不是直接作为根目录，而是通过其邮箱地址或别名访问。
            // 对于Office 365共享邮箱，通常可以直接访问其INBOX。
            // 如果连接的是拥有者邮箱，但需要访问共享邮箱的INBOX，可能需要更复杂的路径或委托访问。
            // 对于直接连接共享邮箱，userEmail应是共享邮箱地址，但认证仍需通过拥有者。
            // 最常见且推荐的方式是，用拥有者账户获取令牌，然后用拥有者账户连接，再访问共享邮箱的文件夹。
            // 访问共享邮箱文件夹的常见模式：
            // inbox = store.getFolder("INBOX"); // 访问拥有者自己的收件箱
            // 要访问共享邮箱，通常需要使用特定的文件夹名称或路径，例如：
            // inbox = store.getFolder("Shared Mailbox/" + sharedMailboxAddress + "/INBOX");
            // 或者，如果令牌是针对共享邮箱的委托权限，可能直接访问 "INBOX" 即可。
            // 实际路径可能因配置而异，建议通过IMAP客户端工具探索。

            // 示例：直接访问共享邮箱的INBOX，假设令牌已授权
            inbox = store.getFolder("INBOX"); // 尝试直接访问INBOX，如果令牌已正确授权共享邮箱访问
            if (!inbox.exists()) {
                 // 如果直接访问INBOX失败，尝试其他路径，例如：
                 // inbox = store.getFolder("Shared Mailboxes/" + sharedMailboxAddress + "/INBOX");
                 // 或者
                 // inbox = store.getFolder("Users/" + sharedMailboxAddress + "/INBOX");
                 // 调试时，可以使用 store.getDefaultFolder().list() 来列出可用文件夹
                 System.out.println("INBOX does not exist, trying to list folders...");
                 Folder defaultFolder = store.getDefaultFolder();
                 Folder[] folders = defaultFolder.list();
                 for (Folder folder : folders) {
                     System.out.println("Available folder: " + folder.getName());
                 }
                 // 根据列出的文件夹调整路径
                 throw new MessagingException("Could not find INBOX for shared mailbox. Check folder path.");
            }

            inbox.open(Folder.READ_ONLY);
            System.out.println("连接成功！");
            System.out.println("共享邮箱 '" + sharedMailboxAddress + "' 邮件数量: " + inbox.getMessageCount());

        } catch (AuthenticationFailedException e) {
            System.err.println("认证失败: " + e.getMessage());
            e.printStackTrace();
        } catch (MessagingException e) {
            System.err.println("邮件系统错误: " + e.getMessage());
            e.printStackTrace();
        } finally {
            try {
                if (inbox != null && inbox.isOpen()) {
                    inbox.close(false);
                }
                if (store != null && store.isConnected()) {
                    store.close();
                }
            } catch (MessagingException e) {
                System.err.println("关闭资源失败: " + e.getMessage());
            }
        }
    }
}