路径错乱是因为 nginx 在处理正则 location 时，会将匹配到的 uri 部分直接拼接到 alias 指定的目录后，而不是像 root 那样替换前缀。要解决这个问题，需要在 alias 路径末尾加上正斜杠，并确保正则表达式能完整捕获需要保留的 uri 部分。
正则 location 中 alias 的路径拼接逻辑是什么
当使用 ~ 或 ~* 修饰符定义正则 location 时，Nginx 的行为与标准 location 不同。它不会尝试从 URI 中移除匹配的前缀，而是将正则表达式中捕获组（括号内）的内容追加到 alias 指定的路径之后。如果 alias 路径没有以斜杠结尾，或者正则表达式没有正确捕获剩余部分，就会导致文件找不到或路径错误。
server {
listen 80;
server_name example.com;
# 错误示例：alias 无斜杠，且未捕获剩余路径
location ~ ^/images/(.*)$ {
alias /var/www/static/images;
}
# 正确示例：alias 有斜杠，捕获组包含剩余路径
location ~ ^/images/(.*)$ {
alias /var/www/static/images/$1;
}
}
在上面的配置中，第一个配置块会导致请求 /images/photo.jpg 时，Nginx 尝试访问 /var/www/static/imagesphoto.jpg，因为 $1 被直接拼接到了路径末尾。第二个配置块则正确地将 $1 作为文件名拼接，从而访问 /var/www/static/images/photo.jpg。
如何避免 alias 与正则 location 的路径冲突
为了避免路径冲突，必须确保正则表达式的捕获组能够准确提取用户请求中需要映射到文件系统的部分。同时，alias 指令的值应该是一个目录路径，通常以斜杠结尾，或者在拼接时使用变量明确指定分隔符。此外，还需要注意权限问题和符号链接的处理。
server {
listen 80;
server_name example.com;
# 推荐写法：使用捕获组并正确拼接
location ~ ^/assets/(.+\.(css|js|png|jpg))$ {
alias /var/www/web/assets/$1;
expires 30d;
}
}
在这个例子中，正则表达式 ^/assets/(.+\.(css|js|png|jpg))$ 捕获了除 /assets/ 之外的所有有效资源路径。alias 指令使用 /var/www/web/assets/$1 将捕获的内容直接附加到目录后。这种写法确保了无论请求的是 /assets/style.css 还是 /assets/logo.png，都能正确映射到 /var/www/web/assets/style.css 或 /var/www/web/assets/logo.png。同时，通过限制文件扩展名，还可以增强安全性，防止访问非预期类型的文件。
alias 路径不存在时会返回什么错误
当 alias 指向的目录或文件在文件系统中不存在时，Nginx 会返回 404 Not Found 错误。这与 root 指令的行为类似，但错误信息可能略有不同，具体取决于 Nginx 的版本和配置。为了调试此类问题，可以启用 Nginx 的错误日志，查看具体的文件路径解析过程。
# 检查 Nginx 错误日志 sudo tail -f /var/log/nginx/error.log # 测试配置文件语法 sudo nginx -t
在测试过程中，如果发现 404 错误，首先检查 alias 指定的路径是否存在，以及 Nginx 进程是否有权限访问该路径。可以使用 ls -l 命令查看目录权限，并使用 sudo -u www-data ls /path/to/alias 模拟 Nginx 工作用户进行访问测试。如果路径存在但依然报错，检查正则表达式是否正确捕获了 URI 部分，以及 alias 拼接后的最终路径是否符合预期。
