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

Excel自定义函数(Shared Runtime)在在线Excel中无法运行求助

Excel在线版自定义函数异常排查方案

针对你基于Shared Runtime开发的Excel自定义函数在在线版无法工作的问题,结合你提供的manifest文件,重点排查以下核心问题:

1. 资源URL未替换为线上地址

你的manifest中所有资源地址(图标、任务窗页、函数脚本等)都使用了https://localhost:3000,在线版Excel无法访问本地localhost地址,必须全部替换为服务器的公网HTTPS域名,比如:

  • 将<IconUrl DefaultValue="https://localhost:3000/assets/lock.png" />改为服务器实际图标地址
  • 所有<bt:Url>中的DefaultValue都要替换为线上部署后的对应路径

2. HTTPS配置不规范

在线版Excel强制要求加载项所有资源通过HTTPS访问:

  • 确保服务器配置了有效的SSL证书(不能用自签名证书,必须是受信任的CA颁发的)
  • 检查所有资源的HTTPS访问是否正常,没有证书警告或连接错误

3. AppDomains未更新

当前manifest的<AppDomains>只配置了localhost,部署后需要添加服务器的域名:

<AppDomains>
  <AppDomain>https://你的服务器域名</AppDomain>
</AppDomains>

否则在线版会触发跨域限制,导致自定义函数无法加载或执行网络请求。

4. 自定义函数代码兼容性

检查函数代码是否使用了桌面版专属API或特性:

  • 避免使用仅桌面版支持的API(如本地文件系统操作、某些Office.js的桌面专属接口)
  • 异步函数的处理要符合在线版沙箱要求,确保Promise正确解析,没有阻塞操作

5. 资源部署完整性

确认服务器上已部署所有必要文件:

  • taskpane.html、functions.js、functions.json、相关依赖脚本
  • 检查服务器返回状态码,确保所有资源都能以200状态正常访问,没有404错误

6. Shared Runtime版本兼容性

虽然你的manifest指定了Shared Runtime 1.1,但在线版Excel需要确保对应的Office.js版本支持,可在任务窗页中确认加载的Office.js版本是否符合要求。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.17 10:05:21