root 和 alias 不能共存于同一 location 块，因二者路径拼接逻辑根本冲突：root 拼接完整 uri，alias 则先剔除 location 前缀再拼接剩余路径，nginx 语法检查直接报错。
不能在同一个 location 块里同时写 root 和 alias。Nginx 会直接拒绝加载配置，nginx -t 就会报错：
nginx: [emerg] "alias" directive is duplicate in ... 或者更常见的："root" directive is duplicate —— 实际上是因为两者互斥，Nginx 只允许其中一个生效，后写的会覆盖前写的，但语法检查阶段就会判定为冲突。
为什么 root 和 alias 不能共存
它们底层逻辑根本相反：
-
root：把整个请求 URI（比如
/api/v1/users.json）原封不动拼到指定路径后面 →/opt/backend + /api/v1/users.json = /opt/backend/api/v1/users.json -
alias：先去掉 location 匹配的前缀（比如
/api/），再把剩余部分（v1/users.json）拼到指定路径后 →/opt/backend/dist + v1/users.json = /opt/backend/dist/v1/users.json
如果硬要在同一 location 里都写上，Nginx 无法决定该用哪套拼接规则，所以直接禁止。
常见“看似混用”实则配置错误的场景
很多人以为自己没混用，但实际是 location 层级嵌套或继承导致行为错乱：
- server 块写了
root /var/www/html;，又在某个location /api/里写了alias /opt/backend/dist/;—— 这本身合法，但容易忽略：其他未匹配的 location 会继承 server 级的 root，而那个 root 拼出来的路径可能根本不存在 - 写了多个 location，比如一个用
root处理前端页面，另一个用alias映射上传目录，但路径有重叠（如location /upload/和location /），导致请求被错误的 location 拦截 - alias 值末尾漏掉
/，例如alias /opt/static配合location /static/，Nginx 会尝试找/opt/staticv1/logo.png（少了个斜杠），而不是/opt/static/v1/logo.png
排查时盯住 error.log 里的真实路径
Nginx 报 404 时，error.log 一定有类似这行：
[error] open() "/var/www/html/api/v1/users.json" failed (2: No such file or directory)
看到这个路径，立刻做两件事：
- 对照配置，确认这个 location 用的是
root还是alias；如果是root，就说明它把完整 URI 拼进去了 —— 那你得检查文件是不是真在那个带前缀的子目录下 - 如果是
alias，就手动去掉 location 前缀，再拼一次：比如日志里是/opt/backend/dist/v1/users.json，而 location 是/api/，那原始请求一定是/api/v1/users.json，说明 alias 路径和请求结构对得上
修复建议：按用途选指令，不交叉
- 想把
/或/app/整个映射到某个目录（比如前端构建产物），用root，且确保目录结构与 URI 路径一致 - 想把某个带前缀的 URL（比如
/media/、/uploads/）单独指向另一个物理位置，用alias，并严格保证location结尾和alias值结尾都有/ - 避免在 server 块设
root后，又在多个 location 里反复用root覆盖 —— 容易拼出多层嵌套路径；统一用alias或集中管理root更可控
