You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
这一行为有文档(gateway README:one immediate retry while the carrier remains available)也有测试(packages/api/gateway/tests/control-retry.client.spec.ts:"permits one isolated retry while the Host remains available")。所以这一层不是回归;问题在它下游,且重试没有延迟,无法吸收瞬时双丢失。
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
摘要
Web 客户端长开标签页时,若同一重连窗口内发生两次连续载体丢失(Host 重启、网络抖动、代理空闲超时),Workspace follow 流会以终态
RemoteError结束且永不重开。侧边栏从此按过期的workspace.sessionIds分组:新建 Session 显示在 "Ungrouped" 下,Workspace 列表不再更新,只有刷新页面才恢复。Session 列表不受影响(它另有推送事件与一元刷新)。我们在 0.2.1-rc.5(
b830ec950f)上复现并定位;四个相关文件在 mastere8f7b93a(0.2.2-rc.2)上逐字节未变。按 CONTRIBUTING 政策,这里不提交 PR,只提供根因、最小复现与两个参考补丁分支。现象
state: "error",但客户端没有渲染这个状态(只有workspaceReady读它,且把 error 当 ready)。冻结标签页里客户端持有的错误对象:
{ "code": "gateway/internal", "details": {}, "isDSHRemoteError": true, "name": "RemoteError", "message": "api gateway: Remote stream WebSocket closed" }现场对比(同一 Host 的两个标签页):
erroridlegateway/internal: api gateway: Remote stream WebSocket closedHost 侧
workspaceRegistry中同一 Workspace 有 131 个成员、新 Session 在索引 0,说明 Host 无过滤问题;新加载的客户端也能正确显示。环境与版本核对
0.2.1-rc.5(b830ec950f),Web profile(dsh web),Windows 11,Chromium 内核浏览器。e8f7b93a(0.2.2-rc.2)核对:git diff HEAD origin/master -- \ packages/api/gateway/src/client/remote-stream.ts \ packages/api/gateway/src/client/snapshot-stream.ts \ packages/api/workspace-controller/src/client/index.ts \ packages/api/workspace-controller/src/client/model.ts # 输出为空:与 0.2.1-rc.5 逐字节相同最小复现
1. Gateway 层
packages/api/gateway/src/client/remote-stream.ts:连接 generation 仍可用时,第一次载体丢失允许一次立即重试,第二次直接终止为gateway/internal(消息取自stream-client.ts的 "Remote stream WebSocket closed")。这一行为有文档(gateway README:one immediate retry while the carrier remains available)也有测试(
packages/api/gateway/tests/control-retry.client.spec.ts:"permits one isolated retry while the Host remains available")。所以这一层不是回归;问题在它下游,且重试没有延迟,无法吸收瞬时双丢失。2. 客户端层(真正的缺陷)
把上述序列喂给
createWorkspaceStateStream(...):第一个 generation 交付 baseline,重试 generation 在 baseline 被接受前失败 →RemoteSnapshotStream把错误交给ClientWorkspaceModel.handleStreamFailure→state = "error"并保留旧快照。之后发布新的健康 generation 也不会再打开任何workspace/follow请求:控制器只启动一次,没有任何重开路径。验证“在 generation 回调里
restart(); start()”这个直觉方案是否可行:写了一个约 50 行的 Node 探针(不连网络——connection.generation是假的,open()按脚本依次返回 baseline 或抛RemoteStreamCarrierError),只观察两个事实:物理上打开了几次流、模型实际收到了哪份 baseline。restart(); start()所以
restart(); start()是空操作:终止失败时RemoteStream的读循环结束、lifetime 被 abort(remote-stream.ts:150-156),而restart()第一行就是if (this.lifetime.signal.aborted) return(remote-stream.ts:61-66);RemoteSnapshotStream.start()有if (this.started) return(snapshot-stream.ts:45-50);RemoteStream还只允许一个消费者(remote-stream.ts:87-93)。恢复只能新建逻辑流。使用探针脚本测试:
3. 现场复现
长开 Web 标签页,期间让 Host 重启两次(或强制两次 stream WebSocket 断开),之后新建一个 Session:它出现在 "Ungrouped" 下;F5 后回到正确 Workspace。
问题原因
RemoteStream.restart()在 lifetime abort 后直接 return(remote-stream.ts:61-66);终止失败会在 consumer iterator 结束时 abort lifetime(remote-stream.ts:150-156);RemoteSnapshotStream.start()首次调用后无效(snapshot-stream.ts:45-50);RemoteStream单消费者(remote-stream.ts:87-93)。connection.generation已定义时抛出(remote-stream.ts:167-170),所以最后一次 generation 变化总是早于失败;之后即使有 generation 变化,遇到的是已死的流,restart()仍是空操作。恢复必须由失败驱动。control.start()一次(packages/api/workspace-controller/src/client/index.ts:47-60),inject里也没有connection。waitForRemoteStreamRetry立即返回(remote-stream.ts:167-170),所以"第二次失败即终止"无法吸收瞬时抖动;但也不能简单取消上限——会变成无退避的热重连循环。api-session/added|removed|status|activity推送事件,并在新 generation 时由sessions.handleConnected()清空投影存储、调用refreshList()(一元remote.session.list)。它的 control stream 失败回调只console.error,同样无法从终态失败恢复——它不是"流恢复"的参考实现。packages/client/ui-workspace/src/client/tree.ts:334的groupByWorkspace用workspace.sessionIds分组,未记账的 Session 全部落入 ungrouped。建议
A. Gateway:有界延迟重试预算(问题)
载体丢失且 generation 可用时,按 250 ms / 500 ms / 1 s 重试;首次延迟让 Connection 先发布 generation 失效;三次后仍失败,以新的客户端 code(建议
gateway/stream-unavailable,details 为空、Host 不抛)终止,使消费方能与协议/业务失败区分。业务与协议失败仍gateway/internal终止。需要同步更新 gateway README、docs/subsystems/web-client.md与既有测试。B. Workspace 控制器:失败驱动重开新逻辑流(兜底)
收到
gateway/stream-unavailable后,dispose 失败的流并新建一个createWorkspaceStateStream,按 500 ms / 1 s / 2 s 有界重开;替换 baseline 到达前保留最后发布的 Workspace 状态;每次接受 baseline 重置重开预算;其他失败保持 error;dispose()取消待定重开并等待进行中的替换。参考
004f95359b)4abde984fb)本地验证:
control-retry17 个、session-controller 与 workspace-controller 的耗尽断言适配)。follow.client.spec.ts7 个用例 + 端到端"4 次载体丢失 → 重开 → 恢复 idle")。pnpm run typecheck:5 gates passed;pnpm run test:docs:21 gates passed。remote-stream.ts、follow.ts、stream.ts均 100%。EPERM的环境问题,与本改动无关。Workaround
刷新页面(F5)。长开标签页在 Host 重启后建议手动刷新。
All reactions