404错误表示服务器已响应请求但未找到对应资源,问题通常出在路径不匹配而非服务宕机;需检查大小写、空格、斜杠、base标签、相对路径解析及服务器实际文件位置。

404 错误不是服务器挂了,而是它“听懂了请求,但找不到东西”——绝大多数情况,问题出在路径没对上,而不是代码或服务本身坏了。
检查 href 和 src 的拼写与解析逻辑
肉眼看着对,不等于服务器认得。Linux 服务器区分大小写,about.html ≠ About.html;Windows 主机虽不敏感,但 CDN、Nginx 或 Jenkins 的 Jetty 层可能严格区分。
- 复制整个
href或src值,粘贴进纯文本编辑器(如记事本),检查开头/结尾空格、全角冒号:、中文引号“”、不可见换行符 - 路径末尾斜杠很关键:
href="blog"和href="blog/"在多数服务器上是两个不同资源;前者可能被重写为blog.html,后者才指向目录索引 - 若用了
<base href="/sub/">,所有相对路径都会被前缀补全——此时href="page.html"实际请求的是/sub/page.html,务必确认base自身拼写正确
用 Network 面板看浏览器真正发了什么请求
别信地址栏显示的 URL,很多“404”其实是 JS 动态改了 href,或点击触发了拦截逻辑,最终发出的请求和你写的完全不一样。
- F12 → Network → 勾选
Preserve log→ 点击链接 - 在列表中找到对应请求,看
Name列:它显示的是浏览器实际请求的完整路径(已补全相对路径、注入 query 参数等) - 右键该请求 →
Copy→Copy full URL,粘贴到新标签页直访:如果也 404,说明路径无效;如果能打开,问题出在原页面的 JS 或 CSP 策略 - 状态码为
0?大概率是跨域、file://协议限制,或目标站返回了Connection: close,和拼写无关
iframe 的 404 多半是路径解析错位,不是文件丢了
iframe 的 src 在 Web 服务器环境下不按文件系统路径解析,而是按当前 URL 路径解析。本地双击打开时走 file:// 协议,行为完全不同,所以“本地能跑,上线就 404”非常典型。
立即学习“前端免费学习笔记(深入)”;
- 不要依赖
../这类相对路径,尤其在 Jenkins、Nginx 或 Flask 部署中;改成以/开头的绝对路径,或完整的http:///https://URL - 例如:把
src="../report/index.html"改成src="/reports/report/index.html"(确保该路径在服务器 DocumentRoot 下真实存在) - 若用 Flask,静态资源必须放在
static/目录下,并用url_for('static', filename='...')生成路径;硬写src="css/style.css"很容易 404
确认文件真正在服务器对应位置,且扩展名没被隐藏
Windows 默认隐藏已知扩展名,你看到的 index.html 可能实际是 index.html.txt;Mac 或 Linux 上则可能因权限或符号链接断裂导致读取失败。
- 在 Windows 资源管理器中启用“文件扩展名”显示(查看 → 显示 → 勾选“文件扩展名”)
- 通过 FTP 或 SSH 登录服务器,执行
ls -l /var/www/html/path/to/file.html,确认文件存在、权限为可读(如-rw-r--r--) - 检查服务器配置:Apache 的
DocumentRoot、Nginx 的root、Flask 的static_folder是否指向你认为的目录 - 若用 Apache,确认
DirectoryIndex index.html已启用;否则访问/blog/不会自动找index.html
最常被忽略的一点:404 是 HTTP 状态码,不是 JavaScript 报错。如果你在控制台看到 404,但 Network 面板里对应请求的状态码是 200,那说明问题不在路径——可能是 JS 逻辑把内容清空了,或者 CSS 把 iframe 隐藏了。先盯住 Network 面板里的 Status Code,再动手改路径。



















