浏览器推理经验怎样沉淀成规则
一次 worker 初始化失败后,我没有只记结论,而是加了启动检查:模型版本、wasm 是否加载、内存申请是否成功。
if (!WebAssembly.validate(bytes)) throw new Error('invalid wasm');
规则写在测试名称里,方便后来的人看到触发条件。样例资源来自公开 fixture,浏览器错误报告不附带页面正文。规则覆盖的是加载失败,不代表推理质量已经通过。
把一次排错记录拆成可复用的事实
浏览器里跑推理时,控制台常常同时冒出模型加载、缓存命中、Worker 初始化和 WebGPU 降级的信息。把整段日志贴进知识库没有太大价值,下一位同学还是得重新猜哪一行是原因。我会先写清现象:是在首开页面、刷新页面还是切换模型后出现;失败时页面是空白、回退到 CPU,还是只得到一个网络错误。接着记录最小条件,例如浏览器版本范围、是否开启跨域隔离、模型文件的来源和缓存状态。没有这些条件的“解决办法”,经常只能在原机器上碰巧成功。
每条经验最好落到一个可以执行的判断上。比如模型文件响应缺少正确的 MIME 类型,就在加载器测试中构造该响应,并断言错误提示指出资源而非笼统地说初始化失败;如果 SharedArrayBuffer 不可用,就在启动前检查隔离头,显示能力不满足的说明,并走不依赖它的路径或停止启动。规则不需要包罗万象,关键是它能在同一条件再次出现时稳定触发。
区分能力检查和业务结果
WebAssembly 校验成功只能说明二进制格式可被接受,不能证明模型权重、算子兼容性或推理结果正确。类似地,WebGPU 适配器可用也不代表显存足以放下某个模型。启动流程应该分层:先检查页面安全上下文与必要的 HTTP 头,再确认资源能下载和校验,随后创建运行时,最后才用一个小输入做冒烟推理。每层都返回自己的错误码和可读信息,界面不必暴露底层堆栈。
这样安排还有一个好处:监控统计的是失败类别,而不是一团“初始化失败”。如果大量用户停在资源下载层,就先看 CDN、缓存规则和版本发布;若只有特定设备在运行时失败,再检查驱动与算子兼容。不要用一次人工复现来推断比例,也不要把用户页面正文、提示词或输入文本塞进错误上报。可匿名的版本、能力开关、错误码已经足够支持排查。
让规则能被维护
我会把规则和对应的 fixture 放在一起,测试名称写出触发条件和预期降级。例如“缺少隔离头时不创建共享内存 Worker”,比“初始化测试二”更容易理解。规则变更必须附带一个之前会失败的样例;如果发现规则过宽,就缩小它的输入范围,而不是在界面上加一层模糊的重试。
浏览器能力变化很快,因此规则也要有删除机制。每次升级运行时或改资源路径时,重跑这批 fixture,标记已经不再适用的兼容分支。经验沉淀的结果不是越来越长的说明文档,而是一组能解释、能验证、也能淘汰的检查点。
另外要保留一次失败的时间线:加载开始、能力检查结束、资源校验完成、运行时创建失败。它比大段调试日志更利于比较版本差异。只有在相同 fixture 上重复出现的现象,才值得进入规则库;偶然的网络抖动则记录为待观察项,不要仓促变成永久分支。
436



被折叠的 条评论
为什么被折叠?



