Echo静态资源需用e.Static()显式挂载，如e.Static("/", "./dist")；API路由须注册在e.Static()前；SPA需自定义中间件fallback到index.html，并做路径校验与clean；Nginx应配置try_files接管fallback，避免请求误入Go服务。
静态资源根目录必须用 e.Static() 显式挂载
Echo 不会自动把 ./dist 或 ./public 当成 Web 根目录。你写 e.GET("/index.html", ...) 没用——它只是注册一个路由，不是启用文件服务。真正生效的是 e.Static("/", "./dist")，这样访问 /main.js 才会去读 ./dist/main.js。
常见错误是：把前端构建产物放在 ./dist，却只配了 e.File("/index.html", "./dist/index.html")。结果除了首页能打开，/assets/app.abc123.js 全部 404。
-
e.Static("/", "./dist")是最简方案，适合纯 SPA（所有非 API 请求都应落到 index.html） - 若同时要提供 /api/ 接口，需确保 API 路由注册在
e.Static()之前，否则会被静态中间件提前拦截 - 路径别写错：
e.Static("/static", "./dist/static")和e.Static("/", "./dist")映射关系完全不同，前者要求 URL 带/static/前缀
SPA 的“兜底路由”得靠自定义中间件，不能只靠 e.File()
Vue/React 项目启用 history 模式后，/user/profile 这种路径浏览器会直接发请求，但服务器上并不存在该文件。这时候需要让所有非 API、非静态资源的请求，都返回 ./dist/index.html。
e.File() 只能处理单个文件，没法做路径 fallback；e.Static() 默认不支持无扩展名回退到 index.html（除非你手动开启 IndexName 配置，但它只对目录有效，对 /user/profile 这类路径无效）。
立即学习“前端免费学习笔记（深入）”；
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 正确做法是写一个中间件：先尝试用
http.Dir("./dist").Open()查原始路径，失败则查./dist/index.html - 务必加白名单判断，比如
strings.HasPrefix(c.Request().URL.Path, "/api/")就直接next(c)，避免把 API 请求也重写成 HTML - 别漏掉
path.Clean()和url.PathUnescape()，否则%2F可能绕过路径校验
Nginx 前置时，location / 规则必须带 try_files
如果你用 Nginx 做反向代理（比如把 /api/ 转给 Echo，其余走本地静态文件），那 Echo 本身就不该承担 fallback 职责。Nginx 得接管这个逻辑，否则多一层 Go 处理纯属浪费。
典型错误配置是只写 location / { proxy_pass http://echo-backend; }，结果所有请求都打到 Echo，连 /logo.png 都走 Go HTTP Server，吞吐直接腰斩。
- 正确写法：
location / { root /var/www/spa; try_files $uri $uri/ /index.html; } -
try_files顺序很重要：先找真实文件，再找目录（触发index.html），最后才兜底到根/index.html - 如果静态资源和 API 同域（如都走
/），Nginx 必须用location ^~ /api/显式截断 API 请求，否则try_files会把/api/user当作文件去找，然后 fallback 到/index.html，造成接口失效
生产环境必须关掉 Debug 模式并校验文件路径
开发时用 e.Debug = true 看错误堆栈没问题，但上线后它会让 Echo 返回完整文件系统路径（比如 open ./dist/not-found: no such file），这等于暴露项目结构。
更危险的是路径遍历：如果用户请求 /../../etc/passwd，而你的中间件没做 path.Clean() + 前缀校验，就可能把敏感文件吐出去。
- 永远用
path.Join("./dist", path.Clean("/"+p))拼接路径，再检查结果是否仍以"./dist"开头 - 禁用
e.Debug，改用日志中间件记录 404/500，不要把错误详情返回给客户端 - 前端构建产物建议加哈希（如
app.a1b2c3.js），配合 Nginx 的expires 1y，避免缓存导致 JS 更新不生效
try_files 顺序或 location 优先级。 
