Nginx 中 alias 映射含空格或中文目录需三要素：路径加引号、客户端自动 URL 编码、location 精确匹配且带尾斜杠；同时确保权限与路径真实存在。
在 Nginx 中用 alias 映射含空格或中文等特殊字符的目录时，关键不是“转义路径”，而是让配置语法合法、URI 编码规范、拼接逻辑清晰——三者缺一不可。
配置中路径必须加引号
Nginx 解析器把空格当作指令分隔符，不加引号会导致配置加载失败或路径截断：
- ✅ 正确写法：
alias "/var/www/my site/中文资源/";或alias '/mnt/data/项目 (2024)/'; - ❌ 错误写法：
alias /var/www/my site/中文资源/;（解析为两个独立参数） - ❌ 错误写法：
alias "/var/www/my\ space/";（反斜杠在 Nginx 配置中无效，不是 Shell）
客户端请求要自动 URL 编码
浏览器或 curl 发起请求时，会自动将空格转为 %20、中文转为 UTF-8 + percent-encoding（如“我的文件.pdf” → %E6%88%91%E7%9A%84%E6%96%87%E4%BB%B6.pdf）。Nginx 内部会自动解码后再与 alias 路径拼接：
- 请求
/static/我的图片.jpg→ 自动编码为/static/%E6%88%91%E7%9A%84%E5%9B%BE%E7%89%87.jpg - Nginx 解码后得到
我的图片.jpg，再拼到alias指定路径后 - 你不需要也不应该在配置里加
rewrite或set做二次解码
location 必须精确匹配且带尾部斜杠
alias 的替换行为高度依赖 location 的结尾格式。含特殊字符的路径更需严格对齐：
- ✅ 推荐写法：
location /static/ { alias "/var/www/my site/中文资源/"; } - ❌ 危险写法：
location /static { alias "/var/www/my site/中文资源/"; }（不带斜杠，可能只截掉/static，剩下/abc.jpg，导致路径错位） - ⚠️ 注意：如果
location以/结尾，alias值末尾也必须带/，否则拼接时会出现双斜杠或路径越界
系统权限和路径真实性不能忽略
即使配置全对，没权限或路径不存在也会返回 403 或 404：
- 确认目标目录真实存在，且 Nginx worker 进程用户（如
www-data）有r-x权限 - 父级目录（如
/var/www）至少要有执行（x）权限，否则无法进入子目录 - 用
curl -I http://localhost/static/测试.txt查看状态码；再查error.log中open()调用的实际路径，验证是否与预期一致
