You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Office Add-In调用REST API失败:配置AppDomain仍无法请求

解决Word Office Add-In外部API请求被拦截的问题

针对你遇到的ERR_NETWORK错误,以下是几个可能遗漏的配置和排查方向:

  • 确认AppDomain配置的正确性
    检查manifest.xml中<AppDomain>的位置和格式:

    • 必须将域名放在<AppDomains>集合下,且仅填写域名根(不能带具体路径),正确配置示例:
      <OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
        <!-- 其他基础配置 -->
        <AppDomains>
          <AppDomain>https://api.example.com</AppDomain>
        </AppDomains>
        <!-- 其他配置 -->
      </OfficeApp>
      
    • 如果是使用VersionOverrides的新版本manifest,需要在对应Host节点下添加<AppDomains>,比如:
      <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
        <Hosts>
          <Host xsi:type="Document">
            <DesktopFormFactor>
              <!-- 其他配置 -->
              <AppDomains>
                <AppDomain>https://api.example.com</AppDomain>
              </AppDomains>
            </DesktopFormFactor>
          </Host>
        </Hosts>
      </VersionOverrides>
      
  • 检查API的CORS策略
    Office Add-In的请求是在Office客户端的沙箱环境中发起的,API服务器必须配置CORS允许来自Office相关域名的请求。开发阶段可以临时设置Access-Control-Allow-Origin: *来测试,正式环境需要添加Office的官方域名(比如https://officeapps.live.com、https://outlook.office.com等)到允许列表。

  • 验证API本身的可用性
    用Postman或浏览器直接访问https://api.example.com/login,确认:

    • API服务正常运行,没有防火墙或CDN拦截
    • HTTPS证书有效(自签名证书会被Office客户端拒绝,导致网络错误)
  • 排除Axios配置干扰
    尝试用原生fetch替代Axios发起请求,测试是否同样报错,比如:

    async function testRequest() {
      try {
        const response = await fetch('https://api.example.com/login');
        console.log(response);
      } catch (err) {
        console.error(err);
      }
    }
    

    如果fetch能正常请求,说明是Axios的配置问题(比如代理、超时设置等)。

  • 检查Office客户端安全限制
    企业版Office可能通过组策略限制Add-In访问外部域名,需要确认客户端的安全策略是否允许你的Add-In访问api.example.com。

内容的提问来源于stack exchange,提问作者jhueg

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.29 05:10:20