Outlook桌面端加载项调用getAccessToken获取Graph令牌触发13012错误
Outlook桌面端Outlook加载项触发13012错误实操排查指引
第一步:先排除官方文档明确标注的三类基础触发条件
- 校验当前Outlook桌面端的IdentityAPI支持版本:在调用接口的前一行执行
Office.context.requirements.isSetSupported('IdentityAPI', '1.10'),确认识别结果为true——如果结果为false,哪怕是Windows桌面端Outlook,只要版本过低不支持带forMSGraphAccess参数的getAccessToken调用,就会稳定触发13012错误,不要仅参考平台支持列表做判断。 - 核对当前加载项的分发场景权限配置:
- 开发旁加载场景:确认Azure应用注册中已经提前配置好所需的Microsoft Graph委托权限,且已经完成管理员同意流程。注意Office内置的授权弹窗只会引导用户授权AAD profile范围的基础权限,不会自动为带
forMSGraphAccess参数的Graph请求完成权限授权,这是旁加载场景下最常见的13012触发点。 - AppSource分发场景:确认当前租户的管理员已经在企业应用管理面板为该加载项授予了对应Graph权限,Office内置授权弹窗不支持引导终端用户完成Graph范围的权限授权,即使弹出授权窗口也无法解决该类问题。
- 开发旁加载场景:确认Azure应用注册中已经提前配置好所需的Microsoft Graph委托权限,且已经完成管理员同意流程。注意Office内置的授权弹窗只会引导用户授权AAD profile范围的基础权限,不会自动为带
第二步:结合项目特征做定向排查
- 排查IE11适配打包的副作用:由于老版本Outlook桌面端基于IE11内核,打包流程可能引入隐藏问题:
- 确认打包压缩阶段没有对getAccessToken的传入参数做属性混淆,实际运行时传入的配置对象中
forMSGraphAccess字段真实存在,没有因为对象拷贝、属性重命名导致参数丢失。 - 确认打包引入的全局polyfill没有覆盖
OfficeRuntime的原生命名空间,避免后续调用时Office无法识别原生API上下文。
- 确认打包压缩阶段没有对getAccessToken的传入参数做属性混淆,实际运行时传入的配置对象中
- 对比官方SSO示例的配置差异:
- 核对加载项清单文件的
WebApplicationInfo配置段,确认Resource ID、权限范围字段与官方示例完全一致,避免因清单压缩、转义导致Office无法正确解析Graph权限配置。 - 检查站点的HTTPS证书信任状态:IE11对证书的信任校验严格,如果自签名证书没有被系统信任根存储识别,会导致Office在静默换token环节的跨域请求被拦截,最终被包装为13012错误抛出。
- 排查本地存储逻辑的兼容性:IE11在Outlook桌面端的进程隔离场景下,localStorage的读写存在兼容性问题,如果把bootstrap token存在本地存储中,会导致Office的认证上下文无法读取到已授权状态,触发权限校验失败。
- 核对加载项清单文件的
第三步:针对“首次调用成功、后续持续报错”的专属定位
在getAccessToken的错误捕获分支中,除了读取错误码,还要打印完整的错误信息:
- 如果错误信息包含“需要授权”类描述,说明Office自身的认证上下文没有记录用户已完成Graph授权,需要检查是否存在代码主动清除Office认证缓存、或提前在Azure侧移除了已授权范围的问题。
- 如果错误信息包含“API不支持”类描述,说明后续调用时代码上下文已经被污染,需要排查打包产物中是否存在全局变量冲突,导致OfficeRuntime的引用被替换为非原生实现。
内容的提问来源于stack exchange,提问作者Walidebisi
相关产品推荐
相关产品推荐

