nginx静态文件404主因是root与alias路径语义混淆：root为拼接（/location/uri→/root/location/uri），alias为替换（/location/uri→/alias/uri），且alias路径末尾必须加/，否则路径粘连导致404。

Nginx 访问静态文件报 404，大概率是 root（或 alias）路径没对上——不是配置写错了，而是路径语义理解偏差导致 Nginx 拼出来的实际文件路径根本不存在。

关键得看你是怎么写的 location，以及你期望访问的 URL 对应哪个物理文件。

root 和 alias 的行为差异必须分清

• root 是“拼接路径”：Nginx 把 location 匹配到的完整 URI 后缀，直接加到 root 路径后面
  比如：

  location /images/ {
      root /mnt/upload/files;
  }

  请求 /images/logo.png → Nginx 去找 /mnt/upload/files/images/logo.png（注意多了一层 images/）

• alias 是“替换路径”：Nginx 把 location 中的前缀去掉，只把剩余部分拼到 alias 路径后
  比如：

  location /images/ {
      alias /mnt/upload/files/;
  }

  请求 /images/logo.png → Nginx 去找 /mnt/upload/files/logo.png（干净利落）

所以如果你的图片实际放在 /mnt/upload/files/logo.png，却用了 root，就一定会 404。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

location 根路径用 root，带前缀路径优先用 alias

• 全站静态资源入口（比如 SPA 的 index.html）：用 root + location /

  location / {
      root /var/www/my-app;
      index index.html;
      try_files $uri $uri/ /index.html;
  }

• 子路径静态资源（如 /api-docs/、/uploads/、/static/）：用 alias，且结尾必须带 /

  location /uploads/ {
      alias /data/uploads/;
  }
  location /docs/ {
      alias /var/www/docs/;
  }

检查三件事，基本能定位问题

• 确认请求的 URL 是什么（比如浏览器地址栏是 https://example.com/css/app.css）
• 查看对应 location 块里用的是 root 还是 alias，路径值是多少
• 手动拼出 Nginx 实际要读的文件路径，然后 ssh 进服务器用 ls -l 看是否存在、权限是否可读

例如：
location /css/ { root /opt/dist; } + 请求 /css/main.css
→ 实际路径是 /opt/dist/css/main.css
如果文件在 /opt/dist/main.css，那显然错，该换 alias /opt/dist/;

别忽略权限和文件存在性

即使路径写对了，也可能因为：

• 文件确实没部署到目标目录
• Nginx worker 进程用户（通常是 www-data 或 nginx）没有读取权限
• 目录缺少执行权限（Linux 下进目录需要 +x）

用这条命令快速验证：

sudo -u www-data ls -l /your/actual/path/file.css

如果报 permission denied 或 No such file，就不是配置问题，是部署或权限问题。