科技行业

HTTP 缓存详解:Cache-Control、ETag、图片和 Apache 配置

HTTP Caching Explained: Cache-Control, ETag, Images and Apache Configuration

学习如何为 HTML、CSS、JavaScript、图片和字体配置浏览器缓存。通过实际示例了解 ETag 和 304 响应,防止文件过时,并使用完整的 Apache .htaccess 配置。

HTTP 缓存详解:Cache-Control、ETag、图片与 Apache 配置

你优化了图片、压缩了 CSS 和 JavaScript。网站加载变快了。但当访客再次访问时,浏览器可能会再次下载相同的文件。

你启用了缓存。一切看起来更好了 —— 直到你替换了一张图片,发现部分访客仍然看到旧图片。

这就是 HTTP 缓存的挑战:复用未变更的文件,但在文件变更时获取新版本。

在本指南中,我们将使用 Apache、PHP 和浏览器开发者工具,为一个真实网站构建缓存策略。

1. 用一个简单示例解释 HTTP 缓存

假设一个网站包含五个文件:

index.html
assets/css/style.css
assets/js/app.js
assets/images/hero.webp
assets/fonts/site.woff2

当有人首次访问你的网站时,浏览器会下载这些文件。

首次访问 —— 浏览器需要所有内容

现在假设访客十分钟后再次访问。

如果服务器之前告知浏览器 CSS 文件可复用一天,浏览器就不需要再次下载它。

浏览器已经有一份副本。

这就是缓存的基本原理。

指令来自随服务器响应发送的 HTTP 头部。

例如:

Cache-Control: public, max-age=86400

这意味着该响应在 86,400 秒(即一天)内保持新鲜可复用。

但如果你在一小时后更新了 CSS 怎么办?

浏览器可能会继续使用旧版本,直到剩余的 23 小时过去。

这就是为什么单纯延长缓存时长是不够的。

2. Cache-Control:发送给浏览器的指令

Cache-Control 头部告诉浏览器和其他 HTTP 缓存如何处理响应。

以下是你最常用的指令。

指令 简单解释
max-age=3600 响应最多可复用一小时
public 共享缓存(包括 CDN)可存储该响应
private 仅存储在私有缓存中,不存储在共享缓存中
no-cache 允许存储,但复用前必须验证
no-store 不存储该响应
immutable 资源在新鲜期间预期不会变更
must-revalidate 过期后,未经成功验证不得复用

有一个特别容易混淆的指令是 no-cache。

它并不意味着“永不存储此文件”。

它的意思是“在使用存储的副本前,先询问服务器该副本是否仍然有效”。

对于绝对不得存储的响应,请使用 no-store。

在配置 HTML 页面和敏感内容时,这一区别至关重要。

3. ETag 详解:浏览器如何询问文件是否变更

让我们具体化一下。

假设你有一个名为 logo.webp 的文件。

浏览器在周一下载了它。

服务器同时发送了一个标识符:

ETag: "logo-version-1"

可以把这个标识符想象成贴在该特定版本图片上的标签。

浏览器保存了图片并记住了标签。

周二,缓存的响应需要验证。浏览器不会立即重新下载整张图片,而是询问:

“你好服务器,我已经有了标识为 logo-version-1 的图片。它还是同一个吗?”

技术上,它发送:

GET /images/logo.webp HTTP/1.1
Host: example.com
If-None-Match: "logo-version-1"

服务器将该标识符与当前版本进行比较。

ETag 条件请求:未变更时返回 304,变更时返回 200

情况 A:图片未变更

服务器回复:

HTTP/1.1 304 Not Modified
ETag: "logo-version-1"

浏览器实际上是在说:“太好了,我继续使用现有的图片。”

服务器不会再次发送图片主体。

情况 B:图片已变更

假设你用新版本替换了 Logo。

服务器现在将其标识为 logo-version-2。

浏览器仍询问 logo-version-1,但服务器回复:

HTTP/1.1 200 OK
Content-Type: image/webp
ETag: "logo-version-2"

这一次,响应包含新图片。

浏览器替换其缓存副本。

ETag 对缓存的作用仅此而已:帮助浏览器检查其副本是否仍为最新。

标识符不必是哈希值或版本号。Apache 可能根据文件元数据生成它,应用程序也可以生成自己的标识符。

亲自测试 ETag

首先,获取响应头部:

curl -I https://example.com/images/logo.webp

找到 ETag:

ETag: "abc123"

然后发送条件请求:

curl -I \
  -H 'If-None-Match: "abc123"' \
  https://example.com/images/logo.webp

如果表现形式未变更,正确配置的服务器可返回 304 Not Modified。

如果已变更,预期返回 200 OK 并附带更新后的表现形式。

一个重要限制: 只要缓存响应仍处于新鲜状态,ETag 并不会强制浏览器联系服务器。如果图片拥有一年的新鲜生命周期,在服务器上更改文件并不保证浏览器会立即检查其 ETag。

这就是资源版本化变得至关重要的原因。

4. 图片缓存:最容易出问题的部分

图片通常是网站上体积最大的资源。

首页可能包含英雄图、分类插图、文章缩略图、Logo、图标和产品图片。

即使压缩为 WebP 或 AVIF,重复下载它们也会浪费带宽。

让我们看看三个真实场景。

场景 A:永不变更的图片

你的网站有一张装饰性图片:

/images/background-v1.webp

你知道每当设计变更时,都会使用新文件名。

你可以放心配置:

Cache-Control: public, max-age=31536000, immutable

浏览器可在一年内复用它,期间无需联系服务器,只要响应保持新鲜。

场景 B:同一文件名下替换图片

你的文章包含:

<img src="/images/article-hero.webp" alt="Article illustration">

你用新图片替换了 article-hero.webp,但保持相同的 URL。

如果浏览器拥有长生命周期的新鲜缓存响应,它可能继续显示旧图片。

解决方法是在内容变更时改变 URL。

例如:

<img src="/images/article-hero.webp?v=2" alt="Article illustration">

或者更好,生成带版本的文件名:

<img src="/images/article-hero-a81c.webp" alt="Article illustration">

现在浏览器看到不同的资源 URL,会请求新图片。

旧缓存图片无害,因为 HTML 不再引用它。

同一 URL 下替换图片 vs 使用新版本化 URL

场景 C:数千张文件名稳定的图片

假设一个编辑类网站包含数千篇文章。

手动重命名每张图片很不方便。

你可以改为选择适中的缓存生命周期(如一天或一周),并在过期后依赖重新验证。

例如:

Cache-Control: public, max-age=86400

在无法自动版本化图片时,这是一个合理的折中方案。

然而,访客在新鲜期内仍可能看到旧图片。

对于必须立即更新的图片,改变 URL 或显式缓存失效更佳。

JPEG、PNG、SVG、WebP 和 AVIF 怎么办?

缓存原则对所有格式都相同。

图片格式 典型用途 缓存策略
JPEG 照片 URL 版本化时使用长缓存
PNG 图形、透明 同上
WebP 优化的网页图片 同上
AVIF 高压缩图片 同上
SVG 图标、Logo、插图 同上
GIF 简单动画 同上

格式影响压缩和解码,但不会从根本上改变 HTTP 缓存行为。

另请记住,响应式图片可能产生多个独立的缓存条目:

<picture>
  <source
    type="image/avif"
    srcset="/images/hero-640.avif 640w,
            /images/hero-1280.avif 1280w">
  <source
    type="image/webp"
    srcset="/images/hero-640.webp 640w,
            /images/hero-1280.webp 1280w">
  <img
    src="/images/hero-1280.jpg"
    alt="Mountain landscape"
    width="1280"
    height="720">
</picture>

每个选中的 URL 都有自己的缓存行为。

如果你替换了图片,请更新每个相关变体的 URL。

5. 使用 PHP 自动为 CSS、JavaScript 和图片添加版本

对于 PHP 网站,你可以利用文件修改时间,避免手动更新版本号。

这是一个小型辅助函数:

<?php

function assetUrl(string $path): string
{
    $file = $_SERVER['DOCUMENT_ROOT'] . $path;

    if(!is_file($file)) {
        return $path;
    }

    return $path . '?v=' . filemtime($file);
}

这样使用:

<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('/assets/css/site.css'), ENT_QUOTES, 'UTF-8') ?>">

<img
    src="<?= htmlspecialchars(assetUrl('/assets/images/hero.webp'), ENT_QUOTES, 'UTF-8') ?>"
    alt="Hero image">

假设文件的修改时间戳为 1794800000。

浏览器接收到的 URL 如:

/assets/images/hero.webp?v=1794800000

当你更新文件且修改时间改变时,URL 也会随之改变。

这是一个简单的缓存破坏策略。

对于生产构建流水线,内容哈希更稳健,因为时间戳在部署过程中可能被保留,或在内容未变时发生变化。

重要提示: 如果你的 CDN 配置为在缓存键中忽略查询字符串,?v= 可能不会产生不同的缓存资源。请验证 CDN 配置,或改用版本化文件名。

6. 不要混淆浏览器缓存、服务器缓存和 CDN 缓存

一个网站可能有多层缓存。

浏览器缓存将响应存储在访客设备上。

CDN 将选定的响应存储在离访客更近的服务器上。

应用缓存可存储生成的 HTML、数据库查询结果或其他计算数据。

这些层解决不同的问题。

例如,即使清除了浏览器缓存,CDN 仍可能提供过期图片。

同样,清除 CMS 缓存并不一定会使浏览器或 CDN 已存储的图片失效。

调试时,先确定是哪一层在提供旧内容,再修改配置。

7. 托管性能与 HTTP 缓存

HTTP 缓存能显著减少重复下载,但无法弥补所有托管问题。

例如,如果未缓存的 PHP 页面因数据库查询缓慢需要两秒生成,浏览器缓存图片无法解决服务器响应时间这一根本问题。

可靠的托管环境应提供合适的 PHP 性能、存储、压缩、TLS 以及对缓存头部的支持。

对于中小型网站,PlanetHoster 等托管商可以成为实用配置的一部分。

对于需要更多服务器资源控制、部署工作流或缓存架构控制的应用,Cloudways 也值得评估。

在更换提供商前,测量实际瓶颈:服务器响应时间、图片体积、PHP 执行、数据库查询,或缓存配置。

8. 如何在 Firefox 和 Chrome 中检查缓存

打开浏览器开发者工具。

在 Firefox 中,按 F12,然后选择网络。

重新加载网站,点击某个图片或样式表请求。

查看其响应头部。

例如:

Cache-Control: public, max-age=86400
ETag: "abc123"
Last-Modified: Mon, 16 Nov 2026 09:00:00 GMT

现在在不禁用缓存的情况下重复导航。

取决于浏览器、资源新鲜度以及导航发起方式,资源可能从本地缓存加载、通过 304 重新验证、或再次下载。

要独立测试特定图片:

curl -sS -D - -o /dev/null \
  https://example.com/assets/images/hero.webp

检查状态、Cache-Control、ETag 和 Last-Modified。

然后使用服务器返回的实际 ETag,带上 If-None-Match 重复请求。

避免仅用强制刷新作为缓存测试:它可能刻意绕过或重新验证缓存响应。

9. 真实网站的完整 Apache .htaccess 示例

最后来看一个实用配置。

此示例针对运行 Apache 2.4 的公开网站,包含静态文件和 PHP 生成的 HTML。

策略特意保守:

  • HTML 进行重新验证。
  • CSS 和 JavaScript 使用七天缓存。
  • 图片使用七天缓存。
  • 字体使用更长缓存。
  • 清单文件使用短缓存。
  • ETag 保持可用于静态文件验证。
  • PHP 响应可设置自己的策略。

这是一个起始配置,而非通用的直接替换方案。部署前请检查托管商的现有规则、已启用模块和 Apache 覆盖权限。

# ============================================================
# HTTP CACHING — APACHE 2.4
# Example configuration for a public website
# ============================================================

# ------------------------------------------------------------
# 1. Static file expiration
# ------------------------------------------------------------

<IfModule mod_expires.c>
    ExpiresActive On

    # Default: validate immediately
    ExpiresDefault "access plus 0 seconds"

    # HTML: validate before reuse
    ExpiresByType text/html "access plus 0 seconds"

    # CSS and JavaScript: 7 days
    ExpiresByType text/css "access plus 7 days"
    ExpiresByType text/javascript "access plus 7 days"
    ExpiresByType application/javascript "access plus 7 days"

    # Images: 7 days
    ExpiresByType image/jpeg "access plus 7 days"
    ExpiresByType image/png "access plus 7 days"
    ExpiresByType image/gif "access plus 7 days"
    ExpiresByType image/webp "access plus 7 days"
    ExpiresByType image/avif "access plus 7 days"
    ExpiresByType image/svg+xml "access plus 7 days"
    ExpiresByType image/x-icon "access plus 7 days"
    ExpiresByType image/vnd.microsoft.icon "access plus 7 days"

    # Fonts: 30 days
    ExpiresByType font/woff "access plus 30 days"
    ExpiresByType font/woff2 "access plus 30 days"
    ExpiresByType font/ttf "access plus 30 days"
    ExpiresByType font/otf "access plus 30 days"

    # Documents: 1 day
    ExpiresByType application/pdf "access plus 1 day"

    # JSON and XML: validate immediately by default
    ExpiresByType application/json "access plus 0 seconds"
    ExpiresByType application/xml "access plus 0 seconds"
    ExpiresByType text/xml "access plus 0 seconds"

    # Web manifest: 1 hour
    ExpiresByType application/manifest+json "access plus 1 hour"
</IfModule>

# ------------------------------------------------------------
# 2. Explicit Cache-Control for static resources
# ------------------------------------------------------------

<IfModule mod_headers.c>

    # HTML: allow storage, require validation
    <FilesMatch "\.html?$">
        Header set Cache-Control "no-cache"
    </FilesMatch>

    # CSS and JavaScript
    <FilesMatch "\.(css|js|mjs)$">
        Header set Cache-Control "public, max-age=604800"
    </FilesMatch>

    # Images
    <FilesMatch "\.(jpe?g|png|gif|webp|avif|svg|ico)$">
        Header set Cache-Control "public, max-age=604800"
    </FilesMatch>

    # Fonts
    <FilesMatch "\.(woff2?|ttf|otf)$">
        Header set Cache-Control "public, max-age=2592000"
    </FilesMatch>

    # PDF documents
    <FilesMatch "\.pdf$">
        Header set Cache-Control "public, max-age=86400"
    </FilesMatch>

    # Data files: revalidate
    <FilesMatch "\.(json|xml)$">
        Header set Cache-Control "no-cache"
    </FilesMatch>

    # Manifest files
    <FilesMatch "\.webmanifest$">
        Header set Cache-Control "public, max-age=3600"
    </FilesMatch>

</IfModule>

# ------------------------------------------------------------
# 3. ETag support for static files
# ------------------------------------------------------------

FileETag MTime Size

# ------------------------------------------------------------
# 4. Compression
# ------------------------------------------------------------

<IfModule mod_deflate.c>
    AddOutputFilterByType DEFLATE text/html
    AddOutputFilterByType DEFLATE text/plain
    AddOutputFilterByType DEFLATE text/css
    AddOutputFilterByType DEFLATE text/javascript
    AddOutputFilterByType DEFLATE application/javascript
    AddOutputFilterByType DEFLATE application/json
    AddOutputFilterByType DEFLATE application/xml
    AddOutputFilterByType DEFLATE image/svg+xml
</IfModule>

# ------------------------------------------------------------
# 5. Avoid caching sensitive PHP responses accidentally
# ------------------------------------------------------------

# Configure dynamic PHP responses in application code.
# Do not apply public caching globally to PHP endpoints.

关于此配置的重要说明

1. 不要复制现有的缓存配置。

如果你的托管商、CMS 或缓存插件已设置这些头部,请谨慎合并策略。

Apache 的 mod_expires 生成过期和 max-age 信息,而 mod_headers 可显式设置 Cache-Control。取决于头部如何生成和内部存储,两者结合可能产生重复或冲突的值。

检查实际 HTTP 响应,必要时简化配置。对于生产部署,为每类资源选择一致的机制更佳。

2. ETag 并非每个响应都必须。

FileETag MTime Size 指令适用于 Apache 服务的文件。它不会自动为动态生成的 PHP 页面提供有意义的验证器。

在分布式服务器上,基于元数据的 ETag 可能还需要额外考虑。

3. 压缩不等于图片优化。

Gzip 适用于 HTML、CSS、JavaScript、JSON 和 SVG 等基于文本的资源。

JPEG、WebP、AVIF 和 PNG 本身已是压缩格式。额外的 gzip 压缩通常收益极小。

如果服务器已支持 Brotli,请在检查现有设置前避免添加竞争性的压缩配置。

4. 七天是一个折中方案。

如果你的所有静态资源都有可靠的版本化 URL,可将其缓存生命周期延长至一年并使用 immutable。

如果你经常在不改变 URL 的情况下替换图片,七天可能仍嫌过长。

根据网站的部署方式选择策略。

10. 部署前后测试配置

使用此清单。

测试 预期结果
请求一张图片 Cache-Control 反映图片策略
请求一个样式表 正确的 CSS 缓存策略
请求 HTML 重新验证策略
请求私有页面 无意外的共享缓存
发送 If-None-Match 未变更且支持验证时返回 304
替换版本化图片 新 URL 加载新图片
检查压缩后的 CSS 适当的内容编码
查看浏览器网络面板 无意外的重复完整下载

例如:

curl -I https://example.com/assets/images/hero.webp

然后:

curl -I https://example.com/assets/css/site.css

最后:

curl -I https://example.com/

对比响应头部。

如果文件缺少预期的缓存头部,验证 Apache 是否实际在服务它、相关模块是否启用、以及 CDN 或应用层是否覆盖了响应。

如果编辑 .htaccess 后网站返回 500 Internal Server Error,恢复之前的配置并检查 Apache 错误日志。不支持的指令或不允许的覆盖是常见原因。

11. CDN 或托管托管何时变得有用

对于不同国家的访客,CDN 可缩短用户与缓存静态资源的距离。

然而,添加 CDN 不一定是改进。

首先,确保图片尺寸和压缩正确、浏览器缓存生效、静态资源 URL 已版本化。

然后衡量 CDN 是否改善了真实交付时间。

具有合适缓存控制的托管平台可简化此设置,但你仍应理解每个响应由哪个缓存层负责。

PlanetHoster 和 Cloudways 是两个值得评估的托管选项,具体取决于应用需求、运维需要和可用的服务器控制权。

重要的问题不是哪个提供商宣传的缓存功能最多。而是你能否可靠地配置、衡量和使缓存内容失效。

结论

一旦你将三个问题分开,HTTP 缓存就容易管理得多:

此响应可否存储?在不检查的情况下可复用多久?浏览器如何知道它是否变更?

Cache-Control 回答前两个问题。

ETag 和条件请求帮助回答第三个。

对于图片、CSS 和 JavaScript 等静态资源,版本化 URL 通常是将长缓存生命周期与即时更新相结合的最可靠方式。

对于 HTML 和频繁变更的内容,重新验证通常更合适。

从保守配置开始,用真实 HTTP 请求测试,仅在理解网站如何处理更新后才增加缓存生命周期。