故障排查

DSH Web UI 空白页排查

判断空白页来自服务未启动、静态资源失败、浏览器缓存还是 Plugin 运行时错误。

由 Plugin Hub 社区维护2 个章节

确认服务与资源响应

先直接请求页面和健康端点，记录 HTTP 状态、响应头和首段正文。连接失败指向服务或端口；HTML 返回 200 后，在无痕窗口打开开发者工具，保留第一条 JavaScript 错误与失败资源 URL。清缓存前先保存证据。

bash

curl -i http://127.0.0.1:3080/
curl -i http://127.0.0.1:3080/health

运行 doctor 和 diff 确认最近升级的 Plugin。若空白页紧随升级出现，回滚到已知可用 revision 做对照，再单独升级可疑 Bundle。

bash

dsh-hub profile doctor --profile web
dsh-hub profile diff <profile-slug> --profile web
dsh-hub profile rollback <revision> --profile web