PAYATHON 2026

img 正常但 button background-image 不显示且同图缓存异常

数据小陈

先说结论

问题大概率不在图片缓存本身,而在 CSS 里的 url() 请求到了另一个路径。<img> 用的是 assets/systemIcons/pfpFrame.png,而 .userPfp 的 background-image 用的是 ./assets/userVariables/pfpFrame.png。两个文件都叫 pfpFrame.png,但目录不同。Application 面板里出现两个同名文件,说明它们对应的请求 URL 并不相同;其中一个加载失败时,DevTools 会显示 failed to load data, resource was not cached。

为什么 <img> 能显示而背景图不显示

<img src> 的 URL 按 HTML 文档的位置解析;CSS 里的 url('./assets/...') 通常按 CSS 文件所在目录解析,不是按 HTML 文件解析。如果 CSS 放在 css/ 或 styles/ 这类子目录里,./assets/... 就会指向另一个位置。再加上文件名相同,很容易误以为是同一张图。

排查步骤

  1. 在 DevTools 的 Network 面板过滤 pfpFrame.png,刷新页面并触发按钮样式,分别查看两个请求的完整 URL、状态码和 MIME type。
  2. 在 Elements 面板选中 .userPfp,到 Styles 里查看 background-image 最终解析出的 URL 是否能直接打开。
  3. 展开 Application > Frames > Top 里的资源,确认两个同名文件的路径是否不同。resource was not cached 更像是 DevTools 缓存预览失败提示,不能只凭它判断成 404。
  4. 检查文件名大小写、扩展名是否确实是 .png、文件有没有损坏,以及构建工具或 Live Preview 是否改写了 CSS 资源路径。

解决方式

让两处引用同一个路径,并确认 CSS 的 url() 是按 CSS 文件位置解析的。比如 CSS 在子目录、assets 在项目根目录时:

.userPfp {
  background-image: url('../assets/systemIcons/pfpFrame.png');
}

如果 CSS 就在项目根目录,或者用了构建工具,也可以改成以站点根为起点的绝对路径:

.userPfp {
  background-image: url('/assets/systemIcons/pfpFrame.png');
}

另外,可以把 HTML 里的测试图也指向同一个资源,方便确认:

<button class="userPfp">
  <img src="assets/systemIcons/pfpFrame.png" alt="">
</button>

改完做一次 hard reload(Ctrl/Cmd + Shift + R),或者在 DevTools 的 Network 面板勾选 Disable cache 再刷新。如果用的是 Vite/Webpack 这类工具,确认静态资源目录以及 public/assets 的规则,必要时用 import 或 new URL() 生成 URL。

注意事项

  • background-size: cover 只影响绘制,不会修复加载失败。
  • align-items 和 justify-content 只有在按钮是 flex 容器时才直接生效。它们不是背景图不显示的主要原因,不过最好确认一下 display: flex。
  • 路径改对后如果还是失败,检查服务器是否对同名资源返回了错误的 MIME,或者 304、缓存逻辑有没有异常,再清理浏览器缓存或临时关闭缓存复测。

备注:内容仅供参考。