Nginx中root指令必须使用绝对路径，不支持相对路径；因root不基于配置文件位置或工作目录解析，误用相对路径会导致404/403；正确写法为root /var/www/my-site;，并需验证目录存在性与Nginx进程读取权限。
在 Nginx 配置中，路径写法直接影响配置能否加载、资源能否正确定位。绝对路径和相对路径不是随意选的，而是由上下文决定的——关键在于搞清“相对于谁”。
绝对路径：以 / 开头，明确指向文件系统位置
所有以 / 开头的路径都是绝对路径，Nginx 直接按操作系统路径查找。
-
include 指令：如
include /etc/nginx/conf.d/app.conf;，Nginx 会严格查找该完整路径下的文件，不存在则报错（启动失败）。 -
root 指令：如
root /var/www/html;，表示该 location 下请求的根目录就是/var/www/html，后续 URI 拼接在此基础上进行。 -
log 文件路径：如
access_log /var/log/nginx/myapp.log main;，日志会写入指定绝对位置，需确保目录存在且 Nginx 进程有写权限。
相对路径：不以 / 开头，基准是 Nginx 的 prefix 目录
相对路径的“根”不是当前配置文件所在目录，而是 Nginx 编译安装时指定的 --prefix 路径（默认通常是 /usr/local/nginx 或 /etc/nginx，取决于安装方式）。例如：
- 若 Nginx 用
--prefix=/opt/nginx编译，则include mime.types;实际查找的是/opt/nginx/mime.types； -
error_log logs/error.log;等价于error_log /opt/nginx/logs/error.log;； - Windows 下同理：
root html;表示C:\nginx\html\（假设 prefix 是C:\nginx）。
include 路径的常见陷阱与建议
include 不是万能粘贴，它依赖上下文，路径错误或内容越界都会导致语法错误。
- 不能在
server块里 include 一个含http { ... }的文件——指令层级错位； - 通配符写法如
include conf.d/*.conf;很方便，但注意匹配顺序按字母排序，不是文件创建时间； - 推荐统一用绝对路径写 include，避免因 prefix 不明导致加载失败，尤其在多环境部署时更可靠；
- 若用相对路径，建议在 nginx -t 测试前确认
nginx -V 2>&1 | grep prefix查看实际 prefix 值。
root 指令的路径继承规则
root 不支持“拼接”，只生效于当前作用域，且 location 中定义会覆盖 server 中的同名设置。
- server 级
root /srv/app;+ location /apiroot /srv/api;→ /api 请求走/srv/api； - server 级
root /srv/app;+ location /static {}（无 root）→ /static 请求仍走/srv/app/static； - 注意：alias 和 root 行为不同，alias 替换整个匹配路径，root 是拼接，别混用。
