Apache仅原样提供构建工具生成的带哈希文件名的静态资源，核心是设对DocumentRoot、禁用MultiViews、确保读权限与SELinux上下文正确，而非用mod_rewrite做映射。
Apache 本身不负责生成或管理静态资源的版本号，它的角色是**原样提供文件**。真正实现版本控制的关键在于：让文件名本身携带唯一标识（如内容哈希），再由 HTML 正确引用——Apache 只需确保能准确找到并返回这个带哈希的文件。
用构建工具生成带哈希的文件名
这是现代前端工程的标准做法，也是最可靠的方式。文件名变化 = 内容变化，浏览器自然请求新资源，彻底绕过缓存问题。
- Webpack 用户：启用 HtmlWebpackPlugin，它会自动把打包后的哈希文件名（如
main.e4f5d2.js）注入<script>标签；配合 webpack-manifest-plugin 输出manifest.json，供服务端模板读取 - Vite 用户：默认开启
build.rollupOptions.output.entryFileNames，生成的 HTML 已含正确哈希路径；开启build.manifest可输出.vite/manifest.json - 手写 HTML 或服务端渲染：构建后读取
manifest.json，在模板中动态插入完整路径，避免硬编码src="/js/app.js"
Apache 配置只需“不干扰”
Apache 不要试图用重写规则去映射旧路径到新文件（比如把 /js/app.js 重写成 /js/app.a1b2c3.js），这类方案需手动维护、易出错、无法覆盖嵌套路径。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 确保 DocumentRoot 指向构建输出目录（如
/var/www/html/dist） - 在虚拟主机或目录配置中加入：Options -MultiViews，防止 Apache 尝试匹配
app.js.gz等变体导致 404 - 确认 Apache 进程用户（如
www-data）对静态文件有读取权限，否则返回 403 而非 404 - 启用
mod_mime和mod_deflate，支持识别和响应已预压缩的.gz/.br文件
不推荐但可临时用的替代方案
如果项目尚未接入现代构建流程，可用服务端动态加参数方式过渡，但稳定性与扩展性较差：
-
时间戳：通过服务端语言（如 PHP 的
filemtime()、Java Velocity 自定义标签）读取文件修改时间，拼为?v=1717442340 -
Git 提交哈希：用
git rev-parse --short HEAD获取短哈希，在构建或部署时注入 HTML -
Maven 插件替换：如
maven-replacer-plugin，在打包阶段批量替换 HTML 中的.js/.css路径，追加?v=yyyyMMddHHmmss
核心逻辑始终一致：让 URL 变化触发浏览器重新请求。构建工具生成哈希文件名是首选，Apache 安静服务即可。
