nginx处理路径空格或中文需引号包裹root/alias路径，uri中空格自动编码为%20，location匹配基于编码后字符串；推荐用英文符号链接规避解析风险，并通过nginx -t、curl及error log验证。
Nginx 对请求路径中空格或特殊字符的处理，核心在于“解析阶段”和“匹配阶段”的双重约束：配置写法必须合法，运行时 URI 处理必须可控。直接放任未编码的空格或中文在路径里，大概率触发 400、403、404 或配置加载失败。
配置层面：root/alias 路径含空格或中文必须加引号
Nginx 配置解析器不把空格当路径一部分，而是当作指令与参数的分隔符。没引号就会截断。
- ✅ 正确：
root "/var/www/my site";或root '/var/www/项目文件'; - ❌ 错误：
root /var/www/my site;（解析为 root 指令后跟两个孤立字符串） - Windows 下注意用英文半角空格，避免中文全角空格导致
unknown directive
运行层面：URI 中的空格被自动转为 %20，括号等变成 %28%29
浏览器发送请求前会做 URL 编码。Nginx 接收到的是已编码 URI，location 匹配也基于这个编码串，不是原始字符。
- 请求
/static/style(v1).css→ 实际到达 Nginx 的是/static/style%28v1%29.css - 所以
location ~ \.css$仍能匹配，但location ~ style\(v1\)\.css$不会命中 - 如需精确匹配编码名，正则要写成
location ~ style%28v1%29\.css$
安全与兼容：避免歧义编码，主动规范化路径
双重编码（如 %252e%252e）、空字节（%00）、目录遍历（%2e%2e）可能绕过常规规则，需显式拦截。
- 统一清理分号干扰：
rewrite ^(/[^;]*)\;.*$ $1 break; - 阻断高危模式：
if ($uri ~ "\.\./|%00|%(2e){2}") { return 403; } - 拒绝非法编码：
if ($request_uri ~ "%[^0-9A-Fa-f]{2}") { return 400; }
更稳妥的做法：用英文符号链接替代特殊路径
不依赖 Nginx 解析特殊字符，从源头规避问题，适合生产环境和自动化部署。
- 创建链接：
ln -s "/var/www/my site" /var/www/my_site - 配置中写：
root /var/www/my_site; - 验证链接有效：
ls -l /var/www/my_site确认指向正确且权限可读
