You need to enable JavaScript to run this app. Excel插件Ribbon点击报0x800c0019证书错误,求本地开发及Azure部署方案
优惠活动
大模型
产品
解决方案
定价
更多

Excel插件Ribbon点击报0x800c0019证书错误,求本地开发及Azure部署方案

问题根因

桌面版Excel和IE内核对HTTPS证书的校验规则远严格于Chromium内核的Chrome/Edge,你遇到的XMLHttpRequest: Network Error 0x800c0019错误本质是加载项访问的资源使用的SSL证书不被系统信任,要么是证书根CA未纳入受信任列表,要么是证书域名和访问地址不匹配。

本地开发环境证书解决方案

你不需要自行从零生成证书,优先用Office官方提供的开发证书工具,配置步骤如下:

  • 首先全局安装官方证书工具:npm install -g office-addin-dev-certs
  • 执行安装命令生成并注册受信任的开发证书:npx office-addin-dev-certs install --days 365
  • 生成的证书默认存储路径:
    • Windows:C:\Users\<你的系统用户名>\.office-addin-dev-certs
    • Mac:~/.office-addin-dev-certs
      目录下会有三个文件:ca.crt(根证书)、localhost.crt(站点证书)、localhost.key(私钥)
  • 将证书配置到你项目的开发服务中:
    如果你用Webpack作为开发服务,在webpack.config.js的devServer配置中添加如下内容:
    const fs = require('fs');
    const path = require('path');
    // 证书路径替换为你本地的实际路径
    const certPath = path.join(process.env.USERPROFILE, '.office-addin-dev-certs');
    module.exports = {
      // 其他配置省略
      devServer: {
        https: {
          ca: fs.readFileSync(path.join(certPath, 'ca.crt')),
          cert: fs.readFileSync(path.join(certPath, 'localhost.crt')),
          key: fs.readFileSync(path.join(certPath, 'localhost.key'))
        },
        host: 'localhost', // 必须用localhost,不能用127.0.0.1或其他域名,否则证书不匹配
        port: 3000 // 和你加载项清单里配置的端口保持一致
      }
    }
    
  • 额外校验点:
    • 加载项清单中所有资源地址(包括函数文件、任务窗格地址、图标资源地址)必须全部为https://localhost:<端口>开头的HTTPS地址,不能混用HTTP
    • 打开系统证书管理器,确认Office Add-in Development CA证书已经出现在「受信任的根证书颁发机构」存储下

如果上述方案仍不生效,你可以用mkcert工具自行生成证书:安装mkcert后执行mkcert -install安装根证书,再执行mkcert localhost生成站点证书,按上述同样方式配置到开发服务即可。

Azure部署证书配置

部署到Azure环境时不需要用开发证书,直接用公网信任的正规证书即可,配置分两种场景:

  • 使用Azure自带域名:如果你用Azure App Service、Azure Static Web Apps等服务,其自带的xxx.azurewebsites.net、xxx.azurestaticapps.net域名已经默认配置了Azure签发的合法SSL证书,你只需要将加载项清单中所有资源地址替换为对应服务的HTTPS地址即可,无需额外配置证书。
  • 使用自定义域名:
    1. 先在Azure对应服务的「自定义域」配置中绑定你自己的域名
    2. 进入服务的「TLS/SSL设置」页面,直接申请Azure免费提供的SSL证书(自动续期,无需额外付费),或者上传你从正规CA机构购买的SSL证书
    3. 绑定证书到自定义域名,确保HTTPS访问正常后,更新加载项清单中的所有资源地址为你的自定义域名HTTPS地址即可。
额外代码优化提示

你提供的btnlogoutservice函数末尾没有调用event.completed(),后续功能正常后也会出现Ribbon点击无响应的问题,建议补充该调用。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.09 17:09:04