2020年10月Mac版Outlook更新后Web加载项附件ID格式错误问题咨询
Mac版Outlook 2020年10月19日更新后IMAP附件下载异常适配指南
对应版本变更核心说明
这次推送的Mac版Outlook内部版本号为16.42(20101807),官方变更日志中和当前异常直接相关的变更项有2项:
- 针对IMAP类型账户的本地邮件存储架构做了底层调整,原有面向EWS协议生成的base64格式附件ID逻辑被替换,新生成的附件ID为本地数据库映射的
362{内部GUID}格式 - 非Exchange Online环境下的IMAP账户,
Office.context.mailbox.restUrl不再默认返回可调用的Graph API地址,原有的容错逻辑直接切换到ewsUrl的链路因为ID格式不兼容,会持续返回Id is malformed的格式校验错误
无可用restUrl、EWS接口不识别新ID场景的适配方案
- 首先做ID格式前置校验:检测到返回的附件ID匹配
^362\{[0-9A-F-]+\}$格式时,直接判定为Mac端新存储模型生成的原生ID,跳过原有EWS拉取、ID base64解析的逻辑分支 - 替换附件拉取实现:针对这类原生ID,统一调用Office.js 1.10及以上版本提供的
Office.context.mailbox.item.getAttachmentContentAsync方法读取附件流,该方法已原生适配Mac端新存储模型的ID规则,不需要额外做格式转换即可正常拉取附件内容 - 后端拉取场景兜底:如果业务流程必须将附件传递到后端服务处理,在识别到这类原生ID的场景下,先通过上述Office.js方法在客户端侧读取完整附件二进制流,再将流数据上传至业务后端,禁止直接将当前的原生ID传入后端的EWS/Graph接口做远程拉取
- 低版本兼容场景兜底:如果现有加载项依赖的Office.js版本低于1.10,暂时无法支持
getAttachmentContentAsync方法,可临时将对应设备的Outlook客户端回滚到16.41(20100900)稳定版本,回滚后附件ID会恢复为原有EWS兼容的base64格式,原有逻辑可正常运行
常见问题提示
- 不要尝试手动将
362{GUID}格式的ID转码为EWS可用的base64格式,该ID为Mac端本地数据库的内部存储标识,无公开的转码规则,强行传参调用EWS接口会持续触发格式校验错误 - 不要在
restUrl为空时强行拼接Graph API地址发起调用,IMAP账户下的Graph接口无本地存储附件的访问权限,强行调用会返回401权限错误
内容的提问来源于stack exchange,提问作者Amyth
相关产品推荐
相关产品推荐

