网站 404 错误总结

网站出现 404 Not Found 通常意味着请求的页面、资源或接口不存在。 它可能来自服务器配置、程序路由、文件缺失、缓存异常等原因。 此页面总结最常见的 404 场景与解决方案。

📌 1. 路由或文件路径错误

• 文件已删除或命名不一致（大小写敏感）
• 前端 SPA（Vue/React）未配置 history 模式 fallback
• Nginx/Apache 未正确指向网站根目录

📌 2. Nginx / Apache 配置不当

• Nginx `root` 或 `alias` 目录设置错误
• 反向代理后端返回 404（API 地址不匹配）
• 伪静态规则未生效，例如 WordPress、Laravel

📌 3. 前端构建路径错误（特别是 Vue / React）

• 部署路径未设置 `publicPath`
• 访问刷新（F5）时前端静态路由丢失
• 静态资源 404（如 CSS/JS 目录不对）

📌 4. CDN / 缓存导致的 404

• Cloudflare / 阿里CDN 缓存了旧路径
• DNS 解析变更后缓存未生效
• 对象存储（OSS/S3）文件被删除但 CDN 仍请求旧地址

📌 5. REST API / 后端程序返回 404

• 接口路由不存在
• 请求方式错误（GET / POST 不匹配）
• API 反代后端路径未拼接正确

• 检查访问 URL 是否正确（大小写必须一致）
• 查看 Nginx / Apache 是否正常加载配置
• 确认文件是否真的存在于服务器指定目录
• 检查前端静态资源路径是否正确
• 使用浏览器 F12 查看具体 404 的资源路径
• 清理 CDN / Cloudflare 缓存
• API 是否被反向代理到正确地址

• 为 SPA 添加 `try_files $uri /index.html`（Vue/React 必备）
• 修复 Nginx root/alias 配置
• 检查程序路由（如 Laravel / ThinkPHP）是否开启伪静态
• 确保静态资源目录未被误删
• Cloudflare → Purge Cache 清缓存
• API 修改后及时同步到反向代理