Static中间件默认只匹配带扩展名的路径，不自动补.html后缀；启用HTML5:true可使未命中路径回退至index.html以支持SPA路由，但不尝试补后缀；Root为磁盘相对目录，非URL前缀；自定义中间件需手动实现补.html逻辑并严格路径校验。
Static中间件默认行为：只认带扩展名的路径
直接调用 middleware.Static("/static") 时，Echo 不会自动尝试补 .html 后缀。比如请求 /dashboards，它不会去找 dashboards.html，而是直接 fallback 到 index.html（如果启用且存在）。这不是 bug，是设计使然 —— 它对标的是传统静态服务器（如 nginx）的默认逻辑，而非 SPA 的 HTML5 History 模式。
StaticWithConfig 配置 HTML5 模式：解决 SPA 路由 404
如果你跑的是 React/Vue/Angular 这类单页应用，需要前端路由接管所有非 API 路径，就得开 HTML5: true：
e.Use(middleware.StaticWithConfig(middleware.StaticConfig{
Root: "public",
HTML5: true,
}))
-
HTML5: true的效果是：当请求路径（如/settings）在文件系统中找不到对应文件或目录时，不返回 404，而是把请求重写为/，交由index.html处理 - 它不改变原始路径匹配逻辑，也不尝试加后缀；只是兜底转发
- 必须确保
Root下有有效的index.html，否则仍会 404 - 该选项和
Browse: true互斥 —— 开了Browse就不能开HTML5，否则 panic
想让 /foo 自动命中 foo.html？得自己写中间件
官方 Static 中间件不支持“无扩展名 → 补 .html → 再 fallback”的三级查找。要实现这个行为，必须手写中间件，核心逻辑是：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 先按原始路径查文件（
fs.Open(name)） - 查不到且路径不以
.html结尾，就再试一次name + ".html" - 还失败，才 fallback 到
index.html
注意：别直接用 http.ServeFile，它不处理 If-Modified-Since 等缓存头；要用 http.ServeContent，并正确传入 file.Stat() 的 ModTime() 和 Name()。
Static 和 StaticWithConfig 的关键区别：Root 是相对路径，不是 URL 前缀
middleware.Static("/static") 中的 /static 是请求路径前缀，而 StaticConfig.Root（比如 "public"）是磁盘上的**相对目录**，不是 URL 路径：
-
e.Use(middleware.Static("/static"))→ 访问GET /static/js/app.js会去读./static/js/app.js -
e.Use(middleware.StaticWithConfig(middleware.StaticConfig{Root: "public"}))→ 访问GET /js/app.js会去读./public/js/app.js，不带 URL 前缀 - 如果希望保留前缀又用自定义配置，得组合
e.Group("/static").Use(...)或在中间件里手动 strip 路径
最容易忽略的一点：所有路径拼接必须过 path.Clean() 和 path.Join()，否则用户构造 ../../../etc/passwd 类路径可能绕过限制 —— Echo 的内置 Static 已做防护，但自定义中间件里漏掉这步就是安全风险。
