Echo框架单页应用路由怎么配？前端静态资源托管指南-Golang-PHP中文网

Echo静态资源需用e.Static()显式挂载，如e.Static("/", "./dist")；API路由须注册在e.Static()前；SPA需自定义中间件fallback到index.html，并做路径校验与clean；Nginx应配置try_files接管fallback，避免请求误入Go服务。

echo框架单页应用路由怎么配？前端静态资源托管指南

静态资源根目录必须用 `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 这类路径无效）。

正确做法是写一个中间件：先尝试用 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 处理纯属浪费。

HISUI 前端框架开发指南（IRIS版）

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。

下载

典型错误配置是只写 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，造成接口失效