root必须是绝对路径且指向index.html父目录，如/var/www/myapp/；错误写法包括指向文件、用相对路径或root与location不匹配；alias需结尾带/且location也须以/结尾；spa需加try_files $uri $uri/ /index.html。
root 必须是绝对路径，且指向 index.html 的父目录
很多人配完 Nginx 打不开页面，第一反应是“没启动”或“端口错”，其实 80% 是 root 路径写错了。Nginx 的 root 不是文件路径，而是 URI 到文件系统的映射基准：它必须是一个**目录**，而且得是绝对路径。
比如你的 index.html 在 /var/www/myapp/index.html，那 root 就该写成：root /var/www/myapp;（结尾斜杠可有可无，但不推荐加）
以下写法全错：
-
root /var/www/myapp/index.html;→ 指向的是文件，Nginx 直接报nginx: [emerg] invalid number of arguments in "root" directive -
root ./myapp;→ 相对路径，Nginx 完全不认，会静默失败或报directory not found -
root /var/www;+ 请求/myapp/→ 实际找的是/var/www/myapp/，但你没在location里声明前缀，根本匹配不到
用 alias 替代嵌套 location 中的 root
当你想把 /app/ 这个 URL 映射到某个独立目录（比如 /opt/my-site/），别用 root，直接上 alias。因为 root 会在原路径后拼接 URI，而 alias 是替换式映射，更可控。
正确写法：
location /app/ {
alias /opt/my-site/;
index index.html;
}
注意两点：
-
alias值末尾必须带/，且location也必须以/结尾，否则 Nginx 会丢掉最后一段路径，导致 404 -
alias块里不能用root，也不能混用index和try_files——index在alias下有效，但行为受限，建议显式写try_files $uri $uri/index.html =404;
SPA 页面刷新 404？加 try_files
Vue、React 这类单页应用依赖前端路由，用户直接访问 /user/profile 时，Nginx 默认只查物理文件，找不到就返回 404。解决方法不是改后端，而是在 location / 块里加一行：
location / {
root /var/www/my-spa;
try_files $uri $uri/ /index.html;
}
这行的意思是：先找真实文件 → 再找同名目录 → 最后兜底到 /index.html（由前端路由接管）。关键点：
-
try_files必须放在最外层location /，不能只放子路径里 - 不要写成
try_files $uri /index.html;—— 缺少$uri/会导致目录访问（如/css/）直接被重写到index.html，CSS/JS 加载失败 - 如果用了
alias，try_files的最后一个参数得写成绝对路径或带前缀，例如/app/index.html
权限和调试：403 和 404 怎么快速区分
Nginx 返回 403（Forbidden）和 404（Not Found）看起来一样，但原因完全不同，排查要走两条路：
- 403：通常是权限问题。检查
ls -ld /var/www/myapp是否为drwxr-xr-x（755），ls -l /var/www/myapp/index.html是否为-rw-r--r--（644）。若属主不是 Nginx 工作用户（如www-data），用sudo chown -R $USER:www-data /var/www/myapp加组，别直接chown www-data - 404：先看 Nginx 错误日志：
tail -f /var/log/nginx/error.log。常见提示如open() "/var/www/myapp//index.html" failed (2: No such file or directory)—— 注意双斜杠，说明root和location拼接出错了；或者"GET / HTTP/1.1" 404 555 "-" "curl/7.68.0"这种没报错路径的，基本是root指向了错误目录 - 每次改完配置，务必执行
nginx -t验证语法，再systemctl reload nginx—— 直接kill -HUP或改完不 reload，旧配置还在跑
最易被忽略的是：Windows 用户在 WSL 或 Docker 里挂载路径时，/mnt/d/xxx 这类路径可能因权限继承或大小写敏感导致 403；Mac 上用 alias 指向 /Users/xxx/Sites 时，需确认该目录对 www-data 用户可遍历（chmod +x 父目录）。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
