Nginx 中 root 与 alias 不能在同一 location 块内共存，否则启动报错；正确做法是在不同 location 中按语义分工：root 用于整站根目录或路径对齐场景，alias 用于子路径映射且末尾必须加斜杠。

Nginx 中 alias 与 root 不能在同一 location 块内混合使用——这不是推荐与否的问题，而是语法硬性限制：Nginx 启动时会直接报错，配置无法加载。

所以“混合使用”实际指的是：在同一个 server 块中，针对不同 location 分别用 root 或 alias，各司其职，互不干扰。这是生产中最常见、最合理的做法。

---

✅ 正确思路：按路径语义分工

• 用 root 处理「整站根目录」或「路径结构与 URL 完全对齐」的场景
• 用 alias 处理「子路径映射」或「URL 前缀需剥离」的场景

例如一个 Vue SPA 部署在 /admin/ 下，同时主站走 /，公共资源又挂载在 /assets/：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

server {
    listen 80;
    server_name example.com;

    # 主站：/ → 整个 dist 目录作为根（结构一致）
    location / {
        root /var/www/web/dist;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # 后台子应用：/admin/ → 映射到独立构建产物，需剥离 /admin/
    location /admin/ {
        alias /var/www/admin/dist/;
        index index.html;
        try_files $uri $uri/ /admin/index.html;  # 注意：fallback 必须带 /admin/
    }

    # 公共图标资源：/assets/icons/ → 指向共享磁盘目录
    location /assets/icons/ {
        alias /mnt/shared/icons/;
    }

    # API 静态文档（如 Swagger）：/api/docs/ → 独立前端页面
    location /api/docs/ {
        alias /opt/swagger-ui/;
        index index.html;
        try_files $uri $uri/ /api/docs/index.html;
    }
}

---

⚠️ 关键避坑点（实操高频出错）

• alias 值末尾必须加 /
  错误写法：alias /var/www/admin/dist; → 请求 /admin/js/app.js 变成 /var/www/admin/distjs/app.js（少斜杠导致路径粘连）
  正确写法：alias /var/www/admin/dist/;

• location 也建议以 / 结尾（尤其匹配目录）
  location /admin/ 是明确前缀匹配；若写 location /admin，可能意外匹配 /admin233，且 alias 行为更难预测。

• try_files 的 fallback 路径要带 location 前缀（仅 alias 场景）
  因为 alias 剥离了前缀，Nginx 不知道你“逻辑上还在 /admin/ 下”，所以 /admin/index.html 必须显式写出，不能简写为 /index.html。

• 不要在正则 location 中滥用 alias（除非必要）
  如 location ~ ^/static/(css|js)/(.*)$ { alias /data/assets/$1/$2; }，虽新版支持，但易因捕获变量失效或路径拼接出错，优先用 root + rewrite 或拆成多个普通 location。

---

❌ 绝对禁止的写法（会启动失败）

location /api/ {
    root /var/www/api;
    alias /var/www/legacy/;  # ❌ 报错："nginx: [emerg] 'root' and 'alias' cannot be used together"
}

Nginx 解析器明确拒绝这种组合——二者底层路径解析机制冲突，无协商余地。

---

不复杂但容易忽略。