Iris MVC中静态资源需在路由层配置而非MVC层，必须用app.StaticWeb（非Static）并配绝对路径与Nginx alias尾斜杠，且须在mvc.New前注册。
在 Iris MVC 中配置静态资源，本质不是“MVC 配置”，而是路由层配置——mvc.Application 本身不处理静态文件，你必须在它所属的 app.Party（或根 app）上显式调用 StaticWeb 或 Static。MVC 只负责控制器逻辑，静态资源得提前挂载，否则所有 /css/、/js/ 请求都会被 MVC 路由忽略或 404。
StaticWeb 和 Static 的核心区别
StaticWeb 是推荐方式，它自动剥离 URL 前缀后匹配本地路径；Static 则原样拼接，容易因路径错位导致 404。
-
app.Static("/static", "./dist")：请求/static/main.js→ 尝试读取./dist/static/main.js（多了一级static） -
app.StaticWeb("/static", "./dist")：请求/static/main.js→ 正确读取./dist/main.js - 若你已把资源放在
./dist/static/下，且想保留 URL 为/static/，那就该写app.StaticWeb("/static", "./dist/static")，而非硬套目录名
路径必须用绝对路径，别信 ./
相对路径 "./dist" 在开发时可能正常，但编译成二进制后，os.Getwd() 返回的是启动目录，不是项目根目录——./dist 很可能指向错地方。
- 正确做法是基于可执行文件位置推导：
exePath, _ := os.Executable()→rootDir := filepath.Dir(exePath)→distDir := filepath.Join(rootDir, "dist") - 如果资源部署在固定系统路径（如
/var/www/myapp/dist），就直接写死："/var/www/myapp/dist" - 绝对路径能绕过工作目录不确定性，上线后不会因
cd /tmp && ./myapp这类操作崩掉
Nginx 反代下 alias 必须带尾斜杠
如果你用 Nginx 把 https://example.com/ 反向代理到 localhost:8080，而 Iris 自己监听 /static/，Nginx 配置稍有不慎就会 404。
- 错误写法：
location /static/ { root /var/www; }→ 实际查找/var/www/static/logo.png，但文件在/var/www/myapp/dist/logo.png - 正确写法：
location /static/ { alias /var/www/myapp/dist/; }→ 注意末尾斜杠，/static/logo.png映射到/var/www/myapp/dist/logo.png - 漏掉尾斜杠（
alias /var/www/myapp/dist）会导致路径拼成/var/www/myapp/distlogo.png，直接 404
缓存头和热更新问题
Iris 默认不设 Cache-Control，但浏览器可能缓存旧 CSS/JS。开发期靠刷新没用，上线后用户端照样卡在旧版本。
- 调试阶段可用
app.UseGlobal(iris.Compression)启用 ETag，配合curl -I /static/main.js看是否返回ETag - 生产环境建议构建时生成哈希文件名（如
main.a1b2c3.js），再配app.StaticWeb("/static", distDir)，彻底规避缓存问题 - 别在 handler 里手动写
ctx.Header("Cache-Control", "...")——StaticWeb不走 handler 链，改了也无效
最容易被忽略的是：MVC controller 的 Get() 方法永远不会响应 /static/xxx 这类请求，哪怕你写了 mvc.New(app.Party("/"))。静态资源路由必须在 MVC 初始化之前注册，顺序错了，连 app.StaticWeb 都没机会生效。
