Office AddIn Excel custom function 运行异常（#BYSY!报错）问题咨询

Excel自定义函数返回#BYSY!及webpack报错解决方案 #

#BYSY!报错本质是Excel无法找到对应自定义函数的运行实现，结合你提到的共享运行时配置场景和webpack模块缺失报错，按以下步骤排查即可解决：

• 核对manifest.xml配置完整性
  1. 确认要求集配置已包含共享运行时支持，CustomFunctionsRuntime要求集版本不低于1.1
  2. 确认Runtimes节点下所有功能（函数、任务窗格、功能区命令）均指向同一个共享运行时ID，生命周期设置为long
  3. 确认FunctionFile节点的资源ID和共享运行时绑定的任务页资源ID完全一致，不要仍指向原独立函数页面
• 修正webpack打包配置
  1. 切换到共享运行时后，删除webpack配置中原独立的functions打包入口，将自定义函数代码合并到任务窗格的打包入口中
  2. 检查webpack配置里的文件路径和项目实际文件路径是否匹配，重点核对大小写、文件夹层级是否拼写错误
  3. 运行npm install重新安装所有依赖，解决截图中模块找不到的编译错误
• 补全自定义函数注册逻辑
  在任务窗格的入口js文件开头添加函数关联代码，示例如下：

  if (Office.context.requirements.isSetSupported("CustomFunctionsRuntime", 1.1)) {
    // 第二个参数为你实际实现的add函数变量名，第一个参数对应函数的ID
    CustomFunctions.associate("ADD", add);
  }
  

• 清理缓存重新测试
  1. 关闭所有Excel窗口，运行npm run stop停止本地开发服务
  2. 清理Office本地加载项缓存：Windows系统删除%LOCALAPPDATA%\Microsoft\Office\16.0\Wef路径下所有文件，Mac系统删除~/Library/Containers/com.microsoft.Excel/Data/Library/Caches/Microsoft/Office/16.0/Wef路径下所有文件
  3. 重新运行npm run start启动项目，等待Excel加载完成2-3分钟后再测试自定义函数

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