Outlook Web加载项调用OneDrive API时出现Version属性空值读取错误

我之前帮不少开发者排查过这类Office加载项的SSO问题，这个错误通常和Office.js的初始化时机、加载项配置或者环境缓存有关，咱们一步步来梳理可能的解决方向：

• 确保Office.js完全初始化后再执行代码
  这个错误最常见的原因就是代码在Office.js还没加载完成时就调用了Office.context.auth相关方法。你需要把你的initializePane()函数放在Office的初始化回调里执行，比如使用Office.onReady()来等待环境准备就绪：

  Office.onReady(function(info) {
    if (info.host === Office.HostType.Outlook) {
      // 确认当前环境是Outlook后再执行初始化逻辑
      initializePane();
    }
  });
  

  避免在页面加载完成后直接调用initializePane()，一定要等Office的上下文完全初始化。

• 检查加载项清单的配置正确性
  清单（manifest.xml）的错误配置会直接导致SSO流程异常：

  • 确认WebApplicationInfo节点中的Id（Azure AD应用程序ID）、Resource（对应你的API资源）配置正确；
  • 确保你声明了访问OneDrive所需的权限范围，比如Files.ReadWrite、Sites.ReadWrite.All等，这些权限需要在Azure AD中提前配置并授权；
  • 检查清单中的Permissions节点是否设置了合适的级别，比如ReadWriteMailbox（如果需要访问邮件附件的话）。

• 清理浏览器缓存并测试环境兼容性
  旧的Office.js缓存或者浏览器兼容性问题也可能引发这个错误：

  • 清空浏览器的缓存和Cookie，然后重新加载Outlook Web和你的加载项；
  • 尝试在Chrome或Edge的最新稳定版本中测试，避免使用过时的浏览器或者Outlook Web的预览版本。

• 排查加载项的加载方式
  如果是通过侧加载方式测试加载项，确保侧加载的流程正确，没有遗漏步骤。可以尝试移除加载项后重新侧加载，确保清单文件被正确解析。

如果以上方法都没有解决问题，你可以尝试在调用getAccessTokenAsync之前打印Office.context的状态，确认auth属性是否存在，不过根据你的错误栈信息，初始化时机和配置问题的概率最高。

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