404错误主因是Web服务器根目录配置错误或路径不匹配：需检查root/DocumentRoot是否指向真实存在且权限正确的路径，注意大小写、符号链接限制、SELinux干扰；SPA需配置fallback规则；Python项目静态文件应由Nginx直接托管而非后端处理；修改配置后务必重载并验证。
Web服务器找不到静态文件：检查根目录配置是否匹配实际路径
404 not found 的根本原因，几乎全是 web 服务器（如 nginx、apache）配置的 root 或 documentroot 指向了一个不存在的路径，或路径权限/大小写不一致。
- 确认你访问的 URL 路径（比如
/static/js/app.js）是否真的存在于你配置的根目录下——别只看项目里有，要进服务器用ls -l /var/www/html/static/js/实际查 - Nginx 的
root是拼接路径的：若配置root /var/www; location /assets { ... }，则真实路径是/var/www/assets；而alias是直接替换，alias /var/www/static/;下location /static/就对应那个目录本身 - Linux 区分大小写：
/Images/和/images/是两个目录，前端请求/images/logo.png但实际只有/Images/logo.png，必然 404 - SELinux 或 AppArmor 可能阻止读取——临时用
setenforce 0测试是否由此引起（仅用于排查，勿长期关闭）
index.html 能打开但子路由 404：单页应用（SPA）缺少前端路由 fallback
Vue/React 项目 build 后部署到 Nginx，/ 能访问，但刷新 /user/profile 就 404，不是配置错了，是服务器没把所有路径都交给 index.html 处理。
- Nginx 需加
try_files $uri $uri/ /index.html;到location /块内，确保非资源请求全部 fallback 到入口 HTML - Apache 要启用
mod_rewrite，并在.htaccess中写RewriteRule ^(.*)$ /index.html [L]（注意AllowOverride All已开启） - 这个规则不能加在
location ~ \.js$这类正则块里——它会覆盖掉对静态资源的正常处理，导致 JS/CSS 也 404
Python Flask/FastAPI 静态文件 404：静态路径未显式注册或路径拼错
本地运行正常，部署后 /static/style.css 报 404，大概率是 WSGI 服务器（如 Gunicorn + Nginx）没把静态请求透传给框架，或框架自己没配好静态服务。
- Flask 默认只在调试模式下提供
/static，生产部署必须由 Web 服务器直接托管该目录——Nginx 配置中加location /static { alias /path/to/your/project/static/; }，注意末尾斜杠和alias的语义 - FastAPI 的
app.mount("/static", StaticFiles(directory="static"), name="static")仅在 Uvicorn 直接运行时生效；Gunicorn 不识别 mount，此时必须让 Nginx 接管静态路径，而非转发给后端 - 检查 Python 进程工作目录：
os.getcwd()输出是否和你写的相对路径（如static/）匹配？推荐全用绝对路径，比如os.path.join(os.path.dirname(__file__), "static")
权限与符号链接导致的 404：Web 服务器用户无法读取文件
路径存在、配置正确、大小写无误，仍 404？很可能是权限拒绝被静默转为 404（尤其 Nginx），而不是报 403。
- Nginx 默认以
www-data（Debian）或nginx（CentOS）用户运行，执行ps aux | grep nginx确认，再用sudo -u www-data ls /var/www/html/static/测试能否列出文件 - 父目录缺少执行（
x）权限会导致整个路径不可进入——/var/www和/var/www/html都需至少rx给 Web 用户 - 用了
ln -s软链？Nginx 默认禁止跟随符号链接，需在server块中加disable_symlinks off;（有安全风险，仅限可信环境）或改用硬链接/复制
最容易被忽略的是：Nginx 配置修改后忘了 nginx -t && systemctl reload nginx，或者 reload 失败却没看日志；还有就是开发时用 VS Code Live Server 跑得好好的，一上生产就卡在路径拼接逻辑里——那不是 Web 服务器的问题，是构建产物没按预期输出到目标目录。
