documentroot 仅定义静态文件物理路径，缓存需在其对应 块中通过 mod_expires（如 expiresbytype image/png "access plus 1 year"）和 mod_headers（如 header set cache-control "public, max-age=31536000"）精准配置，并禁用 html 等动态内容缓存，最后验证资源响应头。
DocumentRoot 本身不直接参与缓存配置，它只是定义静态文件存放的物理路径。真正起作用的是在该目录（或其子路径）上叠加缓存策略——关键在于把缓存规则精准落到 DocumentRoot 所指向的静态资源上，同时避开动态内容。
明确 DocumentRoot 位置并确保可被缓存规则覆盖
先确认 DocumentRoot 设置正确，例如：
-
/etc/apache2/sites-available/000-default.conf 中有：
DocumentRoot /var/www/html - 该目录下存放了
style.css、logo.png、app.a1b2c3.js等真实静态文件 - 确保 Apache 对该目录有读取权限，且
AllowOverride All（如用 .htaccess）或配置直接写在<directory></directory>块内
在 DocumentRoot 范围内启用并配置 mod_expires
缓存逻辑必须绑定到 DocumentRoot 对应的目录上下文，推荐在 <directory></directory> 块中配置，而不是全局或虚拟主机顶层：
Apache 2.4.62
下载
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
- 开启模块：
LoadModule expires_module modules/mod_expires.so（已启用则跳过） - 在
<directory></directory>内添加：
ExpiresActive On
ExpiresByType image/jpeg "access plus 1 year"
ExpiresByType image/png "access plus 1 year"
ExpiresByType text/css "access plus 1 month"
ExpiresByType application/javascript "access plus 1 month"
ExpiresByType font/woff2 "access plus 1 year"
ExpiresByType text/html "access plus 0 seconds"
ExpiresDefault "access plus 0 seconds"
配合 mod_headers 补充 Cache-Control（尤其对带哈希的文件）
仅靠 Expires 头兼容性不足，需在相同 <directory></directory> 块里补充现代缓存头：
- 启用
mod_headers：LoadModule headers_module modules/mod_headers.so - 对 CSS/JS 加 immutable（适用于版本化文件）：
Header set Cache-Control "public, max-age=2592000, immutable"
Header set Cache-Control "public, max-age=31536000"
验证是否真正生效于 DocumentRoot 下的文件
重启 Apache 后，不要只查根路径，而是检查实际静态资源响应头：
- 访问
https://yoursite.com/style.css或https://yoursite.com/images/logo.png - 用浏览器 DevTools → Network → 刷新 → 点击资源 → Headers 标签页
- 确认同时存在：
•Cache-Control: public, max-age=2592000, immutable
•Expires: [未来时间]
• 状态码为200 (from memory cache)或首次为200，再次为304
