Excel自定义函数Web端侧载报错问题求助

1. 部署与跨域配置检查 #

• 确认构建后的静态资源（dist目录产物）已部署至HTTPS服务器，Excel Web端仅允许加载HTTPS来源的插件资源。
• 验证服务器CORS策略：确保Access-Control-Allow-Origin包含Excel Web端域名（如https://*.officeapps.live.com），且允许GET、POST等必要请求方法。
• 打开浏览器F12开发者工具，查看网络面板中自定义函数相关请求的状态码，若存在4xx/5xx错误，针对性修复服务器配置或资源路径。

2. Manifest文件适配验证 #

• 检查Manifest中<Resources>节点下的<Url>，确认指向部署后的HTTPS地址，而非本地localhost路径。
• 确认<Permissions>节点权限设置合理（如ReadWriteDocument），避免权限不足限制功能运行。
• 核对<VersionOverrides>内的自定义函数配置：<FunctionName>、<Script>路径需与部署后的资源路径完全匹配，注意路径大小写。

3. Angular构建打包问题排查 #

• 检查angular.json的构建配置，确认outputPath指向正确产物目录，build命令未遗漏自定义函数脚本等必要资源。
• 执行npm run build --prod重新构建，查看过程中是否有依赖缺失、语法错误等警告/报错。
• 若启用了代码压缩混淆，可尝试临时关闭buildOptimizer或aot选项重新构建，测试是否因压缩导致运行异常。

4. 运行时兼容性校验 #

• 确保自定义函数未使用Node.js专属API（如fs、path模块），Excel Web端仅支持浏览器API与Office.js接口。
• 核对package.json中@microsoft/office-js版本与Yeoman生成项目的依赖一致，避免版本不兼容问题。
• 查看浏览器F12控制台面板的具体报错信息，根据提示定位未定义变量、Office.js加载失败等问题。

5. 侧载环境与流程验证 #

• 确认侧载使用的Excel Web端账号与Manifest中<ProviderName>、<DefaultLocale>等配置匹配，排除账号权限或区域设置冲突。
• 清除浏览器缓存后重新侧载，避免旧资源缓存干扰。
• 切换至Chrome、Edge等不同浏览器测试，排除浏览器特定兼容性问题。

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