前端运行态排障

典型症状

右侧完全空白

优先检查：

1. 页面绑定到了哪个 session
2. 当前 session 是否真的有 last_task_id
3. Auto 是否被错误当成“无 session”

后端有数据，前端没有显示

优先检查：

1. /api/sessions 是否能看到当前 session
2. /api/sessions/:id 是否有 last_frame 和 overlays
3. /api/tasks/:id/status 是否正常
4. 页面层是否只有一个 controller 在写状态

这次真实踩过的坑

根因不是后端没有截图，而是前端把：

• selected_session_id == None

解释成了：

• “没有 session”

但 UI 里的真实语义其实是：

• Auto

结果右侧 controller 根本没有绑定任何 session，页面调试值全是空。

以后遇到类似问题的排查顺序

1. 先确认 session 绑定
2. 再确认 task 绑定
3. 再看 snapshot
4. 最后才看 SSE、观察流和展示组件

不要一上来就怀疑截图生产链路。