Spring Boot集成EWS监听Outlook新邮件遇401认证错误及方案咨询

我希望借助Microsoft提供的EWS API连接至Microsoft Exchange Server，实现Spring Boot应用持续监听Outlook中的新邮件。已编写REST API用于在Spring Boot项目中连接Exchange Server，创建了所需EWS对象并订阅新邮件通知以监听新邮件。

现有代码 #

POM依赖 #

<dependency>   
<groupId>com.microsoft.ews-java-api</groupId>  
<artifactId>ews-java-api</artifactId>  
<version>2.0</version> 
</dependency>

Java控制器代码 #

@PostMapping(value = "/EWSImplementation") 
public Object ewsImplementation() { 

try { 

String userName = "userName"; 
String password = "password";
String serverAddress = "https://outlook.office365.com/EWS/exchange.asmx";

ExchangeService exService = new ExchangeService(ExchangeVersion.Exchange2010_SP2);

ExchangeCredentials credentials = new WebCredentials(userName, password);
exService.setCredentials(credentials);
URI uri = new URI(serverAddress);
exService.setUrl(uri);
exService.setTraceEnabled(true);

PullSubscription subscription = exService.subscribeToPullNotificationsOnAllFolders(500, null,
        EventType.NewMail);

GetEventsResults events = subscription.getEvents();

for (ItemEvent itemEvent : events.getItemEvents()) {
    Item item = Item.bind(exService, itemEvent.getItemId());
    log.info("New email received: {}", item.getSubject());
}
 } catch (Exception e) {
 e.printStackTrace();
 }
}

遇到的问题 #

使用的用户名和密码在Outlook中可正常接收邮件，但调用该API时出现401未授权错误，错误日志显示远程服务器返回(401)Unauthorized。现寻求该错误的解决方法，同时咨询当前通过EWS监听新邮件的方案是否正确。

一、401未授权错误的解决方法 #

1. 替换认证方式 #

Office 365已全面禁用基本认证（直接用户名+密码登录），你当前使用的WebCredentials属于基本认证，这是导致401的核心原因。必须切换到OAuth2认证：

• 在Azure AD中注册应用，获取客户端ID、客户端密钥、租户ID
• 使用MSAL4J库获取OAuth2访问令牌，再通过OAuthCredentials注入到ExchangeService，示例代码片段：

// 先通过MSAL4J获取令牌
IAuthenticationResult authResult = acquireToken();
OAuthCredentials credentials = new OAuthCredentials(authResult.getAccessToken());
exService.setCredentials(credentials);

2. 修正Exchange版本配置 #

代码中使用的ExchangeVersion.Exchange2010_SP2版本过低，与Office 365的EWS版本不兼容，建议改为：

ExchangeService exService = new ExchangeService(ExchangeVersion.ExchangeOnline);

3. 确认邮箱EWS权限 #

登录Office 365 admin中心，或通过PowerShell命令检查目标账号的EWS访问权限是否开启：

Get-CASMailbox -Identity "user@domain.com" | Select-Object EwsEnabled

确保返回的EwsEnabled值为True。

二、当前监听方案的正确性评估 #

1. 现有方案的核心缺陷 #

• 无法实现持续监听：代码仅在接口被调用时执行一次getEvents()，不会主动持续检查新邮件，不符合"持续监听"的需求。
• Pull订阅的局限性：Pull订阅需要定时主动拉取事件，当前代码没有定时逻辑，会错过接口调用间隔内的新邮件。

2. 优化方向 #

• 改用Push订阅：Push订阅是更适合持续监听的方案，Exchange服务器会在有新邮件时主动推送事件到你配置的公网回调URL，无需主动轮询。
• 后台定时拉取：如果坚持使用Pull订阅，需在Spring Boot中添加定时任务（如@Scheduled注解），定期调用subscription.getEvents()拉取新事件。
• 完善异常处理：当前仅打印异常，需添加重试机制、错误告警，避免因临时网络问题导致监听中断。

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