第 05 章
U0001F6E0️排障
进阶
1. 页面空白,控制台报 /assets/ 404
- 原因:2026-11-03 前的旧缓存。已修复:展示站资源全部改
/s/freecut/前缀(快照 ecd8add8a6/775b42c683)。 - 解决:硬刷新(Ctrl+Shift+R)或清空网站数据后重进。
2. /projects 显示“出了点问题 / Workspace root is not set”
- 原因:编辑器需要浏览器文件系统权限(showDirectoryPicker/OPFS),http 下不可用(已验证:
isSecureContext=false)。 - 解决:改走 https 入口
https://leyon.top:8443/s/freecut/,选择工作区文件夹并授权。
3. 公网打开全站 502
- 原因:
119.145.17.34公网隧道/反代故障,与 freecut 无关(内网直连正常)。 - 解决:等隧道恢复后重试,或切内网
http://192.168.11.70:5070/s/freecut/看落地页。
4. “找不到页面 / Not Found”
- 原因:旧版本安装的 PWA / 旧 SW 缓存,或直接访问了深层路甲(展示站无 SPA 回避,刷新深层页会 404)。
- 解决:始终从
/s/freecut/首页进,站内导航不要刷新深层页。