桌面端Excel加载manifest提示错误但不影响功能的问题排查

错误原因定位与修复方案 #

• 资源路径拼写错误
  你 manifest 中所有涉及静态资源目录的路径都把正确的 assets 拼写为 assests，包括 <IconUrl>、<HighResolutionIconUrl> 以及所有按钮图标引用的路径。office-addin-manifest 校验工具只会校验字段格式合法性，不会校验实际资源是否存在，所以校验可以通过，但桌面版Excel加载时无法找到对应图标资源，就会抛出加载错误，不过该错误不会影响已注册完成的功能按钮逻辑执行。
  修复方案：统一修正所有路径中的目录拼写为 assets，确保对应的图标文件确实存在于对应路径下。

• 自定义函数配置与实际实现不匹配
  你在 manifest 中配置了 <ExtensionPoint xsi:type="CustomFunctions"> 自定义函数扩展点，且将自定义函数所需的脚本、页面、元数据地址都指向了 https://localhost:8060/#/index.html，如果你的项目中没有在该页面完成自定义函数的注册、没有提供符合要求的自定义函数元数据，Office加载自定义函数模块时就会触发报错。
  修复方案：如果你不需要使用自定义函数能力，直接删除整个 <AllFormFactors> 节点即可；如果需要使用自定义函数，确保 index.html 中引入了自定义函数的注册脚本，且正确声明了所有自定义函数的元数据。

• 共享运行时初始化异常
  你在 manifest 中声明了需要 SharedRuntime 1.1 依赖，同时配置了全局长生命周期运行时，如果你的加载项初始化代码中存在未捕获的JS异常，会触发运行时加载失败提示。
  修复方案：打开桌面版Excel的调试工具，检查加载项初始化阶段的控制台报错，修复对应JS异常即可。

• 本地HTTPS证书信任问题
  桌面版Excel对本地开发环境的自签名HTTPS证书兼容性较差，如果你的本地服务使用的是未受信任的自签名证书，也可能触发加载错误提示。
  修复方案：将本地开发证书导入系统受信任根证书列表，或者部署到有正规HTTPS证书的测试环境验证。

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