nginx需配置正确root路径、文件权限、index指令及try_files规则才能正确加载html和spa路由。
怎么让 Nginx 正确找到你的 HTML 文件
Nginx 默认不会自动读取当前目录下的 index.html，它只按配置里写的路径去找。很多人把文件丢进 /var/www/html/ 就以为完事了，结果 403 或 404 —— 其实是 root 指向错了，或者文件权限没放开。
实操建议：
-
root指令必须指向包含index.html的**父目录**，不是文件本身。比如文件在/home/user/mysite/index.html，root应设为/home/user/mysite - 确认 Nginx 进程用户（通常是
www-data或nginx）对目录和文件有读取权限：ls -l /path/to/dir看是否可读 - 别用相对路径写
root，Nginx 不支持类似./dist这种写法，必须是绝对路径 - 改完配置后一定要运行
sudo nginx -t验证语法，再sudo systemctl reload nginx
为什么访问时返回 403 Forbidden 而不是显示页面
这不是权限被“禁止”，而是 Nginx 根本没被允许列出目录内容，又找不到默认索引页。典型触发场景：目录下没有 index.html，但配置里又没明确指定 index；或 autoindex on 没开，又没配 index。
实操建议：
- 检查
index指令是否包含你要的入口文件名，例如：index index.html index.htm; - 如果真想列目录（仅开发调试），加
autoindex on;，但生产环境禁用 - 确认目录有执行权限（
x）：Linux 下目录没x权限，Nginx 就无法进入，直接 403 - SELinux 启用时（如 CentOS/RHEL），可能拦截访问，临时关掉测试：
sudo setenforce 0
如何用 Nginx 配置单页应用（SPA）的 history 路由
Vue、React 项目 build 出来扔进 Nginx，点刷新就 404 —— 因为前端路由是客户端处理的，但 Nginx 按真实路径找文件，找不到就报错。
实操建议：
- 在
location /块里加try_files $uri $uri/ /index.html;，把所有未命中静态资源的请求兜底到index.html - 不要写成
try_files $uri /index.html;（漏了$uri/），否则带斜杠的路径（如/about/）会失败 - 如果用了子路径部署（如
/app/），root和try_files都要配合调整，避免重复拼接路径 - 注意：这个配置不能放在
server级别，必须在location块内，否则不生效
修改完 nginx.conf 为什么没生效
改了配置却看不到变化，大概率不是没 reload，而是 reload 失败了，或者 reload 的不是你改的那个文件。
实操建议：
- 先跑
sudo nginx -t，看输出是不是successful。常见错误包括：少分号、括号不匹配、引用了不存在的 upstream - 确认你编辑的是 Nginx 实际加载的配置文件：
sudo nginx -T 2>/dev/null | head -n 20查include路径 - reload 不等于 restart：
sudo systemctl reload nginx是热重载，restart会中断连接，没必要 - 浏览器缓存可能掩盖问题，用无痕窗口或加随机查询参数（如
?v=1）绕过
最容易被忽略的一点：Nginx 的 root 和 alias 行为完全不同，混用会导致路径错乱，而且错误不报在 nginx -t 里，只能靠日志（error_log）定位。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
