nginx 中处理绝对路径与相对路径映射的核心在于理解 `root` 和 `alias` 指令对 uri 拼接逻辑的差异。简单来说，`root` 是将配置的路径作为目录前缀，直接将 location 匹配到的 uri 拼接到其后；而 `alias` 则是用配置的路径完全替换 location 匹配到的 uri 部分。若需将 `/images/` 下的请求映射到服务器上的 `/var/www/images/` 目录，使用 `root /var/www;` 配合 `location /images/` 即可实现 `/images/a.jpg` 到 `/var/www/images/a.jpg` 的映射；若使用 `alias /var/www/images/;` 配合相同的 location，也能达到相同效果，但内部重定向或子请求时的行为会有所不同。
root 指令如何拼接 URI 路径
当使用 `root` 指令时，Nginx 会将 `root` 指定的路径直接追加到 location 匹配到的 URI 之后。这意味着 location 块中的路径前缀会保留在最终的文件系统路径中。例如，如果配置了 `root /var/www/html;` 且 location 为 `/images/`，那么请求 `/images/photo.jpg` 时，Nginx 会在文件系统中查找 `/var/www/html/images/photo.jpg`。这种模式适用于静态资源目录结构与 URL 结构高度一致的场景，因为 URI 中的目录层级直接对应于磁盘上的目录层级。
server {
listen 80;
server_name example.com;
# 配置 root 指令
root /var/www/html;
location /images/ {
# 请求 /images/cat.jpg
# Nginx 查找: /var/www/html/images/cat.jpg
try_files $uri =404;
}
}
在上述代码中，`try_files $uri` 是关键，它直接使用客户端请求的 URI（即 `/images/cat.jpg`）去拼接 `root` 路径。因此，`root` 定义的是“网站根目录”，而 location 定义的是“URL 前缀”。两者结合形成了完整的路径映射。如果 URI 中包含多个层级，如 `/images/2023/vacation.jpg`，Nginx 也会原样保留这些层级，查找 `/var/www/html/images/2023/vacation.jpg`。这种映射方式直观且易于维护，只要确保磁盘目录结构与 URL 结构同步即可。
alias 指令如何替换 URI 路径
`alias` 指令的作用是用其指定的路径完全替换 location 匹配到的 URI 部分。这与 `root` 的拼接逻辑截然不同。使用 `alias` 时，location 中的路径前缀不会出现在最终的文件系统路径中。例如，如果配置了 `alias /var/www/static/images/;` 且 location 为 `/images/`，那么请求 `/images/cat.jpg` 时，Nginx 会查找 `/var/www/static/images/cat.jpg`。注意，这里 `alias` 的值必须是一个目录，且通常以斜杠结尾，否则可能导致路径解析错误。`alias` 更适合于需要将 URL 路径映射到完全不同的物理目录结构的场景，或者当 URL 结构与磁盘结构不一致时。
server {
listen 80;
server_name example.com;
location /images/ {
# 配置 alias 指令
alias /var/www/static/images/;
# 请求 /images/dog.jpg
# Nginx 查找: /var/www/static/images/dog.jpg
# 注意：/images/ 被替换掉了
try_files $uri =404;
}
}
在使用 `alias` 时，`try_files $uri` 的行为需要特别注意。由于 `alias` 替换了 URI，`$uri` 变量仍然保持原始请求的 URI（如 `/images/dog.jpg`），但 Nginx 内部在处理文件查找时，会使用 `alias` 指定的路径。然而，更推荐的做法是使用 `$request_uri` 或在某些情况下调整 `try_files` 的逻辑，以确保路径正确。实际上，对于简单的文件服务，`alias` 配合 `try_files $uri =404` 通常能正常工作，因为 Nginx 内部会将 `$uri` 与 `alias` 路径进行组合。但要注意，`alias` 不能用于正则表达式 location，且必须以斜杠结尾。如果 location 是精确匹配或前缀匹配，`alias` 提供了更大的灵活性来解耦 URL 和文件系统路径。
location 匹配优先级与路径截断问题
在 Nginx 中，location 的匹配优先级遵循精确匹配、前缀匹配（最长前缀）、正则匹配的顺序。当使用 `root` 或 `alias` 时，如果 location 匹配失败或存在多个匹配的 location，可能会导致路径映射错误。例如，如果同时存在 `location /images/` 和 `location /images`（无斜杠），前者会优先匹配 `/images/` 开头的 URI。此外，如果 `alias` 路径末尾缺少斜杠，Nginx 可能会将 URI 的一部分误认为是文件名，导致 404 错误。因此，确保 `alias` 路径以斜杠结尾，并仔细检查 location 的匹配规则，是避免路径映射问题的关键。在实际应用中，建议通过测试不同的 URI 来验证路径映射是否符合预期，特别是当涉及嵌套目录或特殊字符时。
