使用Excel Web加载项自定义函数时Firefox端出现#name错误

核心原因 #

Firefox的同源策略对Office加载项拉取静态资源（如functions.json）的跨域请求限制更严格，当服务器未配置正确的CORS响应头时，会直接拦截请求，导致自定义函数无法加载，触发「#name」错误。

解决方案 #

• 配置服务器CORS响应头
  确保服务器对functions.json及加载项相关静态资源返回正确的CORS头：

  • 必须包含Access-Control-Allow-Origin：建议动态匹配请求的Origin头（避免使用通配符*，Office加载项可能需要携带凭证，通配符不支持该场景）。
  • 需添加Access-Control-Allow-Methods: GET, OPTIONS，处理GET请求及预检OPTIONS请求。
  • 若加载项需携带额外头信息，补充Access-Control-Allow-Headers对应字段。

• 验证清单文件路径准确性
  检查清单中指向functions.json的URL是否与服务器部署路径完全一致，确认协议（HTTPS/HTTP）、域名、路径无拼写错误。本地开发时的路径（如http://localhost:3000/functions.json）需替换为服务器正式路径。

• 确认SharedRuntime配置有效性
  核对清单中Runtime节点的配置，确保ResourceUrl指向的共享运行时入口文件（如taskpane.html）也配置了正确的CORS头，SharedRuntime的加载依赖该资源的跨域访问：

  <Runtime Name="SharedRuntime" MinVersion="1.1">
    <ResourceUrl>https://sfjlemon.ifour-consultancy.net/taskpane.html</ResourceUrl>
  </Runtime>
  

• 排查Firefox隐私设置
  临时关闭Firefox的「增强跟踪保护」功能（设置>隐私与安全>增强跟踪保护），若错误消失，说明是跟踪保护拦截了跨域请求，长期解决方案仍需配置正确的CORS头，而非依赖用户修改浏览器设置。

• 测试跨域响应头
  使用curl命令验证服务器返回的CORS头：

  curl -I https://sfjlemon.ifour-consultancy.net/functions.json
  

  检查响应中是否包含正确的Access-Control-*系列头。

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