GUI 路由与静态资源处理说明
本文档说明了在将前端 SPA(Vue + Vite)构建产物由后端(aiohttp)托管时,如何处理静态资源与前端路由以避免深层链接(deep link)访问时出现 、空白页或 ERR_INVALID_RESPONSE 的问题。
问题背景在开发模式下,Vite 的开发服务器会对所有未命中静态资源的请求返回 index.html,从而让前端使用 HTML History 模式的 router(createWebHistory)来处理路径。但在生产环境,当前端静态文件被打包放到后端并由后端静态路由提供时:
直接在地址栏输入深层链接(例如 /gui/home/settings)会向后端发起请求。若后端没有将未命中静态资源的请求回退到 index.html,则服务器会返回 或其他错误,导致页面空白或浏览器报错。
若后端把根路径重定向为 /gui/index.html,浏览器地址栏会显示 /index.html,前端 router 会把路径解析为 /index.html 而不是 / 或 /home,导致路由无法匹配并出现空白。
目标
...




