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(私钥)
- Windows:
- 将证书配置到你项目的开发服务中:
如果你用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地址即可,无需额外配置证书。 - 使用自定义域名:
- 先在Azure对应服务的「自定义域」配置中绑定你自己的域名
- 进入服务的「TLS/SSL设置」页面,直接申请Azure免费提供的SSL证书(自动续期,无需额外付费),或者上传你从正规CA机构购买的SSL证书
- 绑定证书到自定义域名,确保HTTPS访问正常后,更新加载项清单中的所有资源地址为你的自定义域名HTTPS地址即可。
额外代码优化提示
你提供的btnlogoutservice函数末尾没有调用event.completed(),后续功能正常后也会出现Ribbon点击无响应的问题,建议补充该调用。
内容的提问来源于stack exchange,提问作者sagar
相关产品推荐
相关产品推荐

