alias实现动静分离的关键是精准替换而非拼接：匹配URL前缀后直接替换为alias路径，末尾斜杠必须与location一致，避免粘连错误；需并列配置、禁用嵌套，动态走proxy_pass、静态走alias，带hash资源配合try_files或rewrite处理。
用 alias 配置路径别名做动静分离，关键在于“精准替换”，不是拼接。它让 Nginx 把请求中匹配的 URL 前缀整个去掉，再把 alias 后面的路径直接贴上去——不加斜杠、不补路径、不看上下文。
alias 和 root 的区别必须分清
很多人 404 就是因为混用了 root 和 alias：
-
root /var/www/html;+location /static/ { ... }→ 实际找/var/www/html/static/xxx -
alias /var/www/assets/;+location /static/ { ... }→ 实际找/var/www/assets/xxx（删掉 /static/ 后直接拼） - 如果写成
location /static/ { alias /var/www/assets; }（末尾没斜杠），而请求是/static/js/app.js，Nginx 会去找/var/www/assetsjs/app.js—— 少了斜杠就粘连出错
动静分离要平级写，别嵌套
不要在 location / 里再套一个 location /api/ 并在里面用 alias。父子嵌套容易触发匹配优先级混乱或继承失效：
- ✅ 推荐：所有动静规则并列写，互不干扰
- ❌ 危险：
location / { root /app; location /static/ { alias /cdn; } }—— 子 location 可能根本不会生效 - 动态接口统一走
proxy_pass，静态资源统一走alias，逻辑彻底隔离
带哈希的静态资源怎么处理
现代前端打包常生成带 hash 的文件名（如 main.a1b2c3.js），但 URL 路径仍是 /static/js/main.js。这时单靠 alias 不够，得配合 try_files 或 rewrite：
- 用
try_files $uri @fallback;先试原路径，找不到就进 fallback 块重写 - 或者用
rewrite ^/static/js/(.+)\.js$ /static/js/$1.[a-z0-9]{6}\.js break;（需配合正则和实际 hash 规则） - 更稳妥的做法：构建时输出真实映射表，用 Lua 或 OpenResty 动态查表，但中小项目通常用
try_files+ 缓存策略就够了
常见配置示例（可直接参考）
以下是一组安全、清晰、无嵌套的典型配置：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"># 动态接口全部交给后端
location /api/ {
proxy_pass http://127.0.0.1:8000/;
proxy_set_header Host $host;
}
# 静态资源用 alias 精确映射
location /static/css/ {
alias /opt/webapp/dist/css/;
}
location /static/js/ {
alias /opt/webapp/dist/js/;
}
location /images/ {
alias /opt/webapp/public/images/;
}
# 补充通用静态类型兜底（可选）
location ~* \.(jpg|png|gif|ico|woff2|svg)$ {
root /opt/webapp/public;
expires 1y;
}}
注意每个 alias 值末尾的斜杠必须和对应 location 的结尾一致；所有路径都手动画过一遍计算过程，就不会错。
