在 nginx 中处理包含中文或特殊字符的 `root` 路径，核心做法是将配置文件编码统一为 utf-8，并在配置文件中直接使用 utf-8 编码的文件名。nginx 主进程和 worker 进程通常以 utf-8 读取配置文件，只要文件保存格式正确且路径字符串匹配，即可正常访问。若遇到 404 错误，需检查文件系统实际编码是否与配置一致，并排除 url 编码差异导致的匹配失败。
root 指向含中文目录时为何返回 404
当 root 指令指向包含中文的目录时，返回 404 通常是因为配置文件保存编码与 Nginx 解析编码不一致，或者 URL 中的中文被浏览器自动编码导致路径不匹配。Nginx 默认将配置文件视为 UTF-8 编码，如果编辑器将配置文件保存为 GBK 或其他编码，Nginx 读取到的字节序列就会出错，从而无法匹配到正确的文件系统路径。此外，客户端请求 URL 中的中文会被编码为百分号形式（如 %E4%B8%AD%E6%96%87），而 root 匹配的是解码后的文件系统路径，因此必须确保文件系统路径、配置文件中的路径字符串以及解码后的请求 URI 三者完全一致。
server {
listen 80;
server_name localhost;
# 假设文件系统路径为 /var/www/网站资源/index.html
# 配置文件必须保存为 UTF-8 编码
root /var/www/网站资源;
location / {
try_files $uri $uri/ =404;
}
}
上述配置中，root 设置为 /var/www/网站资源。当用户访问 http://localhost/index.html 时，Nginx 会将 $uri 解析为 /index.html，并与 root 拼接成 /var/www/网站资源/index.html。如果文件系统确实存在该路径，且配置文件是 UTF-8 编码，则能正常返回文件。若使用 try_files，它会先尝试匹配精确文件，再尝试匹配目录，最后返回 404。确保文件系统路径中的中文没有经过额外的转义或编码转换是关键。
URL 编码与文件系统路径的映射冲突如何解决
解决 URL 编码与文件系统路径冲突的方法是使用 autoindex 进行调试，或通过 rewrite 显式处理编码问题，但更推荐的做法是避免在路径中使用非 ASCII 字符，或使用 charset 指令确保响应头正确。如果必须使用中文路径，需确保 Nginx 版本支持 UTF-8 路径（现代版本均支持），并且客户端发送的请求 URI 与文件系统路径在解码后完全一致。可以通过 access_log 查看 Nginx 实际接收到的 $uri 值，对比文件系统路径，找出差异。
server {
listen 80;
server_name localhost;
charset utf-8;
root /var/www/测试目录;
location / {
# 记录实际解析的 URI，用于调试
access_log /var/log/nginx/access.log combined;
try_files $uri $uri/ =404;
}
}
在上述配置中，charset utf-8 确保响应内容编码正确。通过查看 access_log，可以确认 Nginx 接收到的 $uri 是什么。例如，如果用户访问 http://localhost/%E6%B5%8B%E8%AF%95，Nginx 会将其解码为 /测试，然后尝试匹配 /var/www/测试目录/测试。如果文件系统路径是 /var/www/测试目录，且内部文件名为 index.html，则需确保请求路径正确。若发现 404，检查日志中的 $uri 是否与文件系统路径一致，必要时调整 root 或 location 规则。
特定输入下 try_files 的行为验证
在 root 包含中文且使用 try_files 的情况下，若请求路径对应一个不存在的文件但存在同名目录，try_files 会尝试将该目录作为索引目录处理。如果目录中没有 index.html 且 autoindex 未开启，则会返回 403 或 404。具体行为取决于 try_files 的参数顺序和文件系统状态。例如，请求 /中文目录/ 时，若 /var/www/中文目录/ 存在且为空，try_files 会尝试匹配 /中文目录/，若未找到文件，则根据最后一个参数决定返回 404 还是其他错误。
