使用EWS Java API无法读取完整邮件正文的原因及解决方法

问题原因 #

• EWS Java API 默认的EmailMessage.bind方法仅加载邮件基础属性，对于包含Teams会议信息的邮件，会优先返回会议结构化数据，默认未加载完整对话正文。
• 带Teams会议的邮件可能属于会议类Item（如MeetingResponse），这类Item的正文存储逻辑与普通邮件不同，默认绑定操作未覆盖完整正文字段。

解决方法 #

1. 显式指定加载完整属性集 #

绑定邮件时，使用带PropertySet的重载方法，明确要求加载全量属性或指定正文相关属性：

// 加载所有第一类属性，包含完整正文
PropertySet propSet = new PropertySet(BasePropertySet.FirstClassProperties);
EmailMessage message = EmailMessage.bind(service, new ItemId(item.get(nMessagePos).getId().getUniqueId()), propSet);
String emailBody = message.getBody().toString();

也可仅指定加载正文属性并指定格式：

PropertySet propSet = new PropertySet(ItemSchema.Body);
propSet.setRequestedBodyType(BodyType.HTML); // 按需切换为BodyType.Text
EmailMessage message = EmailMessage.bind(service, new ItemId(item.get(nMessagePos).getId().getUniqueId()), propSet);
String emailBody = message.getBody().toString();

2. 针对会议类Item单独处理 #

如果邮件属于会议响应类（如MeetingResponse），可直接读取HtmlBody或TextBody属性：

if (message instanceof MeetingResponse) {
    MeetingResponse meetingResp = (MeetingResponse) message;
    String htmlContent = meetingResp.getHtmlBody();
    String textContent = meetingResp.getTextBody();
}

3. 检查ConversationHistory属性 #

部分带对话的邮件，正文内容可能存储在ConversationHistory中，可尝试加载该属性：

PropertySet propSet = new PropertySet(ItemSchema.Body, ItemSchema.ConversationHistory);
EmailMessage message = EmailMessage.bind(service, new ItemId(item.get(nMessagePos).getId().getUniqueId()), propSet);
// 处理ConversationHistory中的对话内容

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