如何通过Spring Boot实现向Outlook日历添加事件并配置提前邮件提醒

核心实现思路 #

无需自行维护轮询定时任务，直接通过Outlook/Exchange官方提供的接口能力实现日历事件创建，同时使用服务端推送订阅能力实现提醒触发，完全规避本地轮询逻辑。

方案1：Microsoft Graph API（适配Outlook 365、新版Exchange环境，官方首选） #

依赖引入 #

Maven依赖配置如下：

<dependency>
    <groupId>com.microsoft.graph</groupId>
    <artifactId>microsoft-graph</artifactId>
    <version>6.3.0</version>
</dependency>

实现步骤 #

1. 在Azure AD后台注册应用，获取日历操作相关权限完成身份认证
2. 构造日历事件对象，配置事件基础信息、提前15分钟、提前5分钟的提醒规则
3. 调用接口创建日历事件，同时注册推送订阅，将提醒事件关联到你的服务端公网回调接口
4. 回调接口收到微软服务器的提醒推送时，直接执行发送通知邮件的业务逻辑

代码示例 #

// 构造日历事件
Event event = new Event();
event.subject = "待办事项提醒";
// 配置事件起止时间
DateTimeTimeZone start = new DateTimeTimeZone();
start.dateTime = "2024-07-01T10:00:00";
start.timeZone = "Asia/Shanghai";
event.start = start;
DateTimeTimeZone end = new DateTimeTimeZone();
end.dateTime = "2024-07-01T11:00:00";
end.timeZone = "Asia/Shanghai";
event.end = end;
// 配置多时段提醒规则
event.reminderMinutesBeforeStart = 15;
// 额外5分钟提醒可通过事件扩展属性实现
// 创建事件
graphClient.me().events().buildRequest().post(event);

// 注册推送订阅，指定回调接口
Subscription subscription = new Subscription();
subscription.changeType = "updated";
subscription.notificationUrl = "https://你的服务公网地址/outlook/callback";
subscription.resource = "me/events";
subscription.expirationDateTime = OffsetDateTime.now().plusDays(1);
graphClient.subscriptions().buildRequest().post(subscription);

方案2：EWS（Exchange Web Services，适配旧版本地部署Exchange环境） #

依赖引入 #

Maven依赖配置如下：

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

实现逻辑 #

EWS同样支持推送通知订阅能力，创建事件时配置对应提醒规则后，订阅提醒事件回调即可，触发逻辑和Graph方案一致，无需本地轮询。

关键注意事项 #

• 回调接口必须为公网可访问的HTTPS接口，否则微软服务无法完成推送
• 订阅存在有效期，需要根据业务需求定期续期，避免订阅过期后无法收到提醒
• 事件创建时需要统一时区配置，避免提醒时间出现偏差

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