应先查看Network面板中404请求的Request URL，确认浏览器实际发出的路径，再比对文件系统与服务器配置；CSS中url()以CSS文件路径为基准，iframe/script的src需用绝对路径避免解析偏差。
检查 Network 面板里真实的 Request URL
浏览器控制台显示的“404”只是表象，真正要盯的是 Network 标签页里那个标红请求的 Request URL。它告诉你服务器到底收到了什么路径——不是你“以为”的路径，而是浏览器实际发出的。
- 点开 404 请求 → Headers → 找
Request URL，比如显示http://localhost/css/style.css，但你的文件其实在assets/css/style.css，那就得改 HTML 中的<link href="assets/css/style.css"> - 如果 URL 含
%C3%B6这类编码，说明原路径有非 ASCII 字符（如café.css），而服务器上文件名是未编码的cafe.css—— 建议统一用 ASCII 命名，避开编码歧义 -
Initiator列能帮你定位来源：如果是index.html发起的，说明是 HTML 里写的路径错了；如果是某个app.js发起的，就得查 JS 里动态拼的 URL
CSS 中 url() 的路径基准容易被忽略
CSS 文件里的 url() 不以 HTML 所在位置为基准，而是以 CSS 文件自身所在路径为起点。构建工具（如 Webpack/Vite）常会重写资源路径，但本地直接双击或用简单服务器跑时，这个规则就暴露得特别明显。
- 假设
main.css在/css/main.css，里面写了background: url("../images/logo.png")，那浏览器会请求/images/logo.png，而不是/css/images/logo.png - 构建后输出目录变了，但 CSS 里
url()没同步更新？检查构建配置里的publicPath或assetPrefix是否匹配最终部署结构 - 本地测试别用
file://协议：它不解析相对路径的 HTTP 上下文，url("../img.png")会直接失败，且不会报 404（而是 CORS 或空响应）
iframe 和 script 标签的 src 容易因相对路径错位
<iframe src="report.html"></iframe> 在子页面 /admin/dashboard.html 下会被解析成 /admin/report.html，哪怕你本意是根路径下的 /report.html。这不是 HTML 写错了，是相对路径解析逻辑和你预期不一致。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
- 一律改用绝对路径：
src="/report.html"（开头带/）或完整 URL：src="https://cdn.example.com/report.html" - 避免
./和../：某些托管环境（如 Jenkins 的 Stapler 引擎、旧版 Jetty）对上级目录支持极差，src="../data/index.html"几乎必 404 - 动态设置时用
new URL("report.html", window.location).href更可靠，它按当前页面 URL 自动解析上下文，比手拼字符串安全得多
静态资源不在 Web 根目录下，服务器压根不提供
很多框架（Django、Flask、Spring Boot）默认只暴露特定目录（如 /static/、/public/）下的文件。你把图片扔在 HTML 同级目录，服务器根本不会去读那个位置——不是路径写错了，是它根本不被允许访问。
立即学习“前端免费学习笔记（深入）”；
- Django 必须把资源放进
static/子目录，并用{% static 'images/logo.png' %}渲染；直接写src="images/logo.png"就会 404 - Tomcat 只服务
webapps/yourapp/及其子目录，webapps/static/是另一个独立应用，跨目录引用（如src="../static/logo.png"）会被拒绝 - GitHub Pages、Vercel 等平台只托管构建产物目录（如
dist/或build/）下的内容，确保你的 CSS/JS 图片都已正确输出到该目录，且 HTML 中引用路径与产物结构一致
最常被跳过的环节是：没确认服务器是否真在提供那个路径。一个 404 请求背后，可能是路径错、配置漏、大小写敏感、编码不一致，或是资源根本没被纳入服务范围——先看 Request URL，再对文件系统，最后查服务配置，顺序不能乱。
