应先打开浏览器开发者工具的 Network 面板，刷新页面后查看标红请求的 Request URL 和 Status Code，确认真实请求路径与服务器返回状态，再结合服务器根目录映射、文件物理位置及重定向头等信息综合判断是否为真 404。

看 Network 面板里的真实请求路径和状态码

浏览器开发者工具的 Network 面板是定位 404 的第一现场。很多人只看地址栏或弹窗提示，但真正决定是否 404 的是服务器返回的 status code 和实际请求的 URL。

打开 F12 → Network → 刷新页面，找到标红的请求（通常是 HTML 文件本身，或 iframe、script、img 的 src），点开它，重点看：

• Request URL：浏览器到底发了什么地址？比如显示 http://localhost:8080/pages/report.html，但你文件实际在 ./src/report.html，就必然 404
• Status Code：确认是 404 还是 200（软 404）、403（权限问题）或 0（CORS/跨域拦截）
• Response Headers 中的 Location：如果有重定向，说明后端逻辑跳转到了一个不存在的地址

检查文件是否真在服务器可访问路径下

404 的本质是“服务器找不到这个文件”，不是“你本地打不开”。关键要确认两件事：文件物理位置 + 服务器根目录映射关系。

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• Apache/Nginx：检查 DocumentRoot 指向的目录，你的 HTML 必须放在该目录或其子目录里
• Tomcat：HTML 必须放在 webapps/yourapp/ 下（yourapp 是上下文路径），不能放错到 webapps/ROOT/ 外的任意位置
• Node.js（如 express.static()）：确认 app.use(express.static('public')) 的路径是否包含你的 HTML 所在目录
• Jenkins/Jetty：它不按常规 Web 目录结构服务静态文件，src="../xxx" 在 iframe 中极易失效，必须改用完整 URL（如 src="http://jenkins/job/xxx/artifact/xxx.html"）

区分是真 404 还是软 404 或前端假 404

很多所谓“404”根本不是 HTTP 层面的错误，而是前端逻辑误判或状态码伪装。

立即学习“前端免费学习笔记（深入）”；

• Flask/Django 等后端返回 "NO" 字符串，但状态码仍是 200 —— 这是业务逻辑错误，不是 404
• 页面返回 200 状态码，但内容是 “Page not found” —— 这是软 404，搜索引擎会持续抓取，必须改成 return Response("Not Found", status=404)
• AJAX 请求中 processData: false + contentType: false 导致 Flask request.form 为空，进而走错分支返回空或错误响应 —— 浏览器 Network 里看到的是 200，但前端 JS 认为失败，误标为“404”
• iframe 加载失败时控制台报 404，但主页面状态码是 200 —— 问题出在 iframe 的 src 解析，不是主 HTML

验证服务器是否真在服务这个路径

别依赖“我启动了 XAMPP 就一定行”。直接用 curl 或 telnet 绕过浏览器验证底层连通性。

• 执行 curl -I http://localhost/index.html，看返回的 HTTP/1.1 404 Not Found 还是 200 OK
• 如果返回 curl: (7) Failed to connect，说明服务根本没起来，或端口被占（如 lsof -i :80 查占用）
• 如果返回 403 Forbidden，说明文件存在，但服务器配置禁止访问（常见于未开启目录浏览且无 index.html）
• Linux/macOS 上用 ls -l 确认文件权限：Web 服务器用户（如 www-data）必须有读权限；Windows 上注意 NTFS 权限和“隐藏扩展名”导致的 index.html.txt 问题

真正的 404 原因往往藏在请求路径与服务器根目录的映射缝隙里，而不是代码写错了。最常被忽略的是：你以为的“相对路径”在服务器眼里根本不是那个相对法，尤其是带 iframe、fetch 或部署在 Jenkins/Tomcat 这类非标准环境时。