布局 flush 不再等待封面链
Project CI / Repository checks (pull_request) Successful in 1m11s
Project CI / Frontend tests (pull_request) Successful in 3m6s
Project CI / Backend tests (pull_request) Successful in 3m52s
Project CI / Native shell tests (pull_request) Successful in 12m6s

flushProjectPersistence 显式关掉 queueProjectLayoutSave 内建的 fire-and-forget
封面分支,自己另起一份并在最后 await。于是每个 await flush 的调用方都被挂在
封面链后面:封面渲染要为每个可绘制图层取 signed URL 再 new Image() 加载,而
那个 Image 只有 onload/onerror,没有 timeout 也没有 AbortSignal,外层的
try/catch 只接得住 reject、接不住「永不 settle」。一张图不 settle,生成 POST
就永远发不出去。

这是「完美像素请求账本移出项目布局」把严格通道与普通 flush 合并成一条路径时
引入的回归——改动前 strict 分支在封面链启动之前就 return,两者是结构性隔离的。
图集拆分一直走非严格路径,暴露是既有的,但同源,一并解开。

必然发生的是延迟:封面签名含未量化的 viewport,而创建占位时会移动视口,所以
几乎每次完美像素都触发全量重渲染,而这些与服务端那个 409 前置毫无关系。可能
发生的是挂死:此时 finally 永不执行,图层锁与归属登记被永久持有,用户删掉占位
也没用——闸的另一半是静默 return,再点没有任何反应。

删除式修复:去掉 persistCover: false 覆盖、独立的 coverSave 与末尾的 await,
让封面回到 queue 内建的 fire-and-forget 分支。参数逐项等价,封面照存,只是不再
有人等它。未采纳加选项的方案,那会把同一问题留在图集拆分身上。

代价是 returnToProjects 不再等封面就跳转;该保护本就很薄——SPA 跳转不会打断
promise,真正打断它的是页面卸载,而 await 在 beforeunload 里同样救不了。

遗留:loadProjectCoverImage 里无界的 new Image() 仍是隐患,自动保存路径一样会
踩,本次只是把它移出生成链的关键路径。建议单开。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-05 12:43:40 +00:00
parent 4ccfdc68f6
commit dee91b6889
3 changed files with 61 additions and 20 deletions
@@ -1010,15 +1010,13 @@ export function useImageCanvasProjectPersistence({
canvasBackgroundColor: refs.canvasBackgroundColorRef.current,
}),
};
queueProjectLayoutSave(nextProjectId, layoutInput, {
persistCover: false,
});
const coverSave = persistProjectCoverSnapshot(
nextProjectId,
coverDisplayViewport,
refs.layersRef.current,
);
// 中文注释:封面走 `queueProjectLayoutSave` 内建的 fire-and-forget 分支,flush **不等**
// 它。此前 flush 显式关掉那条分支、自己起一份并在最后 `await`,于是任何 await flush 的
// 调用方都被挂在封面链后面——而封面渲染要为每个可绘制图层取 signed URL 再 `new Image()`
// 加载,那个 Image 没有 timeout 也没有 AbortSignal,一张图不 settle 就永远不 settle。
// 完美像素与图集拆分 await flush 只为满足一个服务端前置:占位/图层布局已经持久化。那个
// 前置在下面的队列排干时就已满足,封面与它无关,不该挡在 POST 前面。
queueProjectLayoutSave(nextProjectId, layoutInput);
while (
activeProjectLayoutSavePromiseRef.current ||
pendingProjectLayoutSaveRef.current
@@ -1037,14 +1035,8 @@ export function useImageCanvasProjectPersistence({
break;
}
}
await coverSave;
},
[
persistProjectCoverSnapshot,
queueProjectLayoutSave,
refs,
runPendingProjectLayoutSave,
],
[queueProjectLayoutSave, refs, runPendingProjectLayoutSave],
);
const applyCreatedProjectResourceLayer = useCallback(