Chrome及Edge打开Google Sheets插件侧边栏报TransportError错误

问题基础特征 #

• 异常仅在 Chrome、Microsoft Edge 这类 Chromium 内核浏览器中触发，同版本插件在 Firefox 浏览器中所有功能运行正常
• Chrome 环境下捕获的完整错误信息：

message: "There was an error during the transport or processing of this request. Error code = 10, Path = /wardeninit"
name: "TransportError"

• 已尝试过该错误码对应的所有公开社区通用解决方案，问题未解决

可落地排查方向 #

• 第一优先级排查Chromium内核独有的网络拦截逻辑
  • 检查第三方Cookie拦截配置：Chrome/Edge 近年版本默认对跨域iframe的第三方Cookie执行严格拦截，Google Apps Script 侧边栏初始化依赖的 /wardeninit 接口需要携带跨域鉴权Cookie，Firefox 对该场景的默认拦截规则更宽松，是出现浏览器差异的最常见原因。可临时将Google相关站点的Cookie权限设置为「允许所有Cookie」，关闭「阻止第三方Cookie」开关后测试功能是否恢复。
  • 排查本地扩展拦截：广告拦截、隐私防护、脚本管理类扩展在Chromium内核下的规则匹配逻辑和Firefox存在差异，很容易误拦截Apps Script的初始化请求。直接打开浏览器无痕模式（默认禁用所有非内置扩展）访问对应表格测试，如果无痕模式下功能正常，逐个禁用已安装扩展定位拦截源即可。
  • 检查企业策略限制：如果是工作/学校配发的 managed 设备，可在地址栏输入 chrome://policy（Edge浏览器输入 edge://policy）查看是否存在跨域请求拦截、Google服务域名限制类的管理员下发策略，这类策略通常不会在Firefox上生效。
• 第二优先级排查前端初始化兼容问题
  • 核对google.script.run的调用时机：Chromium内核下Apps Script客户端SDK的初始化速度和Firefox存在差异，如果在SDK未完成加载、DOM未解析完成时就提前发起服务端调用，会直接触发该传输错误。可将侧边栏首次服务端调用逻辑绑定到window.onload事件触发后执行，测试是否复现错误。
  • 检查全局请求方法修改逻辑：如果侧边栏代码里存在重写全局fetch/XMLHttpRequest原型的逻辑（常见于埋点SDK、请求拦截工具库），Chromium下的重写逻辑可能破坏Apps Script SDK内置的鉴权头注入规则，Firefox下原型链调用逻辑的差异不会触发该问题，可临时注释这类全局请求修改代码测试。
• 第三优先级排查插件配置与缓存问题
  • 重置插件授权：如果近期调整过插件的OAuth授权范围，Chromium下本地缓存的旧授权凭证和最新权限范围不匹配时，会触发初始化阶段的传输错误。可在Google账号的第三方应用权限管理页移除该插件的所有授权，重新打开插件走完整授权流程测试。
  • 清理站点缓存：Chromium内核对Apps Script静态资源、Service Worker的缓存策略比Firefox激进很多，破损的旧版本SDK缓存会直接导致初始化失败。可清除Google Sheets站点的本地缓存、已存储的Service Worker，硬刷新页面后重新打开侧边栏测试。

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