nginx通过显式location规则（如location ^~ /static/）优先匹配并截断请求，由root指定本地目录直接响应文件，不转发至后端echo；关键在规则前置、^~高效匹配、root路径映射准确及配置expires缓存头。
动静分离时，Nginx 怎么把 /static/ 请求直接返回文件而不走 Echo？
只要 location 规则优先匹配到静态路径，Nginx 就根本不会把请求交给后端 Echo 应用。关键不是“转发”，而是“截断”——让 Nginx 自己处理并响应。
常见错误是只配了 proxy_pass 却没写 location /static/，结果所有请求（包括 /static/css/app.css）都打到了 Echo，白白消耗 Go 进程和内存。
- 必须显式声明静态路径，例如：
location ^~ /static/ { root /var/www/html; expires 365d; } -
^~前缀比正则更高效，且能确保它优先于可能存在的location ~ \.go$等规则 -
root指向的是本地目录根，所以/static/js/main.js会去查/var/www/html/static/js/main.js；若用alias，路径映射逻辑不同，容易少一层目录 - 别漏掉
expires或add_header Cache-Control，否则浏览器每次都要发 If-Modified-Since 请求
前端请求 /api/user，但 Echo 启在 /v1/user，Nginx 怎么做路径剥离？
核心不是靠 rewrite，而是靠 proxy_pass 末尾斜杠的行为。这是最常被误解、也最容易出错的一环。
- 写成
location /api/ { proxy_pass http://echo-backend:8080/v1/; }→ 错：Nginx 会把/api/user改成/v1//user（双斜杠），后端 404 - 正确写法是：
location /api/ { proxy_pass http://echo-backend:8080/v1/; }→ 注意proxy_pass末尾有/，且location末尾也有/，这样 Nginx 才会把匹配到的/api/完全剥离，只把user发给后端 - 如果 Echo 监听的是根路径（
/user），那就该写proxy_pass http://echo-backend:8080/;，而不是http://echo-backend:8080（不带斜杠） - 验证方法：在 Echo 里打印
r.URL.Path，看收到的是/user还是/api/user
Ingress-nginx 场景下，怎么让 /v2/(.*) 映射到 Echo 的 /$1？
在 Kubernetes 中，你不能直接写 rewrite 指令，得靠注解 + 正则 path 配合，而且版本差异直接影响写法。
- 1.23+ 集群必须用
pathType: Prefix或ImplementationSpecific，不能用Exact - 注解必须包含：
nginx.ingress.kubernetes.io/rewrite-target: /$2，同时 path 写成/v2(/|$)(.*)，这样$2才能捕获真实路径（如/user/profile） - 务必加
nginx.ingress.kubernetes.io/use-regex: "true"，否则正则不生效 - 别写
rewrite-target: /—— 这会把所有请求都压平到根，/v2/user变成/，Echo 收不到原始语义 - 测试时 curl 加
-v看响应头里的X-Original-URI，确认重写是否按预期发生
为什么加了 rewrite last 还是 404？
rewrite 不是万能补丁，它只是 URL 字符串改写，后续是否生效取决于是否触发内部重定向、以及有没有匹配的新 location。
-
last表示重写后重新匹配location，但如果你没写对应的新location，或者新路径没被任何location捕获，照样 404 -
break是停止当前块内后续 rewrite，并直接用新路径去 upstream，但不会重新匹配 location —— 更适合简单前缀替换 - echo 框架默认不处理静态文件，所以
rewrite ^/favicon.ico$ /static/favicon.ico break;之后，必须有location /static/能接住这个请求 - 调试技巧：打开 Nginx error log 的
notice级别，能看到每条 rewrite 是否执行、是否匹配成功
