Office JS insertWorksheetsFromBase64本地正常，部署Firebase/AWS失效

问题详情 #

• 基于Flutter Web开发Excel插件，实现了一套包含保存当前Excel文件、新建工作簿、通过Office JS的insertWorksheetsFromBase64方法从模板导入工作表的函数逻辑
• 本地localhost环境运行完全正常，但部署至Firebase或AWS后该功能直接失效，其他Office JS相关功能均能正常工作
• 已准备复现仓库，包含本地加载插件及复现问题的完整步骤

排查方向与解决方案 #

1. CORS跨域限制

   • 部署后的模板静态资源可能存在跨域问题，导致Office JS无法正常获取并转换为Base64内容。
   • 排查：查看浏览器控制台的网络请求日志，确认模板文件加载是否出现跨域错误。
   • 解决：在Firebase/AWS的资源配置中添加CORS规则，允许Office客户端域名访问静态资源；或直接将模板文件嵌入插件包内，避免跨域请求。

2. HTTPS混合内容拦截

   • Office客户端要求插件运行在HTTPS环境下，若部署后模板资源通过HTTP加载，会被浏览器拦截。
   • 排查：检查浏览器控制台是否有「Mixed Content」警告。
   • 解决：确保所有资源（包括模板文件）均通过HTTPS加载，在部署平台配置中强制启用HTTPS。

3. Base64编码一致性问题

   • 本地与部署环境中，模板文件的Base64编码可能出现差异（如多余换行符、编码格式不一致）。
   • 排查：对比本地和部署环境下生成的模板Base64字符串，确认内容完全一致。
   • 解决：确保模板文件在打包部署时保持二进制完整性；或在代码中对Base64字符串做标准化处理（去除多余换行、空格）。

4. Office JS权限配置

   • 部署后的插件可能因权限不足，导致insertWorksheetsFromBase64调用受限。
   • 排查：检查插件清单文件中的权限声明，确认是否包含ReadWriteDocument级别权限；同时确认Office客户端的插件权限设置。
   • 解决：在清单文件中声明足够的操作权限，并引导用户完成授权。

5. Flutter Web资源路径错误

   • Flutter Web打包后，模板文件的实际访问路径可能与代码中写死的路径不一致，导致无法读取文件生成Base64。
   • 排查：验证部署后模板文件的实际可访问路径，对比代码中的资源路径配置。
   • 解决：使用Flutter的rootBundle加载打包后的资源，确保路径在部署环境中依然有效。

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