Excel Office Add-In实现Azure AD认证时Office.context.auth未定义求助

我来帮你一步步梳理这个问题——开发Office Add-in SSO时碰到Office.context.auth未定义是个挺常见的坑，咱们从这几个核心方向排查：

1. 确保Office.js正确加载并完成初始化 #

Office.context.auth是Office.js提供的SSO相关API，必须等Office.js完全加载并初始化后才能访问。

• 首先检查你的页面是否通过官方CDN加载完整版Office.js，不要用简化版：

  <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>
  

• 所有依赖Office.context的代码都要放在Office.initialize回调里，确保Office.js初始化完成后再执行：

  Office.initialize = function(reason) {
    $(document).ready(function() {
      // 在这里调用你的getDataWithToken函数，或者初始化相关逻辑
    });
  };
  

如果跳过初始化直接调用API，大概率会出现属性未定义的情况。

2. 检查Add-in Manifest的SSO配置是否完整 #

SSO功能需要在manifest里声明关键配置，缺少的话Office不会初始化Office.context.auth对象：

• 必须添加<WebApplicationInfo>节点，包含你的Azure AD应用的Client ID、Resource URI和所需权限：

  <WebApplicationInfo>
    <Id>你的Azure AD应用Client ID</Id>
    <Resource>api://你的域名/你的Client ID</Resource>
    <Scopes>
      <Scope>Files.Read.All</Scope>
      <Scope>offline_access</Scope>
    </Scopes>
  </WebApplicationInfo>
  

• 确认<Permissions>节点设置了足够的权限（比如ReadWriteDocument），权限不足也会影响SSO相关API的启用。

3. 验证Office客户端环境是否支持SSO #

Office.context.auth只在支持SSO的Office环境中可用：

• 必须是Office 365订阅版（Windows版Office 2016及以上、Mac版Office 2016及以上、Office Online），本地批量许可版的Office通常不支持SSO功能。
• 避免在旧版客户端或者非订阅环境中测试，这类环境不会加载SSO相关的API模块。

4. 查看开发者工具的错误日志 #

打开对应的开发者工具（Web版用浏览器控制台，桌面版通过Add-in的调试入口打开），检查是否有：

• Office.js加载失败的网络错误
• 权限声明不合法的报错
• 其他与SSO配置相关的警告信息
  这些日志能帮你快速定位具体的配置或加载问题。

5. 确认Office.js版本符合要求 #

如果是本地引用Office.js，可能版本过旧不支持SSO。建议始终使用官方CDN的最新版本，至少要使用v1.8及以上的Office.js版本（SSO功能是在这个版本引入的）。

如果以上步骤都排查完毕还是有问题，可以再核对教程里的manifest配置细节，比如Resource URI的格式是否严格遵循api://域名/ClientID的要求，有没有拼写错误。

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