Nginx无法直接移除URL中的查询参数版本号，但可通过rewrite忽略参数、构建工具生成哈希文件名、设置immutable缓存策略等方式实现逻辑隐藏，核心是让版本号对服务端无意义且客户端不因参数差异重复请求。
直接在 Nginx 配置中移除 URL 中的版本号（如 /js/app.js?v=1.2.3 或 /css/style.css?version=202405）是做不到的——Nginx 本身不解析查询参数来改写静态文件路径。但你可以通过重写（rewrite）或响应头控制，让版本号“不生效”或“不暴露”，从而实现逻辑上的“隐藏”。核心思路是：忽略查询参数、统一缓存策略、避免版本号出现在真实文件路径中。
用 rewrite 忽略查询参数，统一指向无版本文件
如果前端请求类似 /static/js/main.js?v=2.1.0，而你的真实文件是 /static/js/main.js，可配置 Nginx 跳过 ? 后所有内容，只按路径匹配静态文件：
location ~ ^/static/.*\.(js|css|png|jpg|gif|woff2?)$ {
# 去掉查询参数，只保留路径部分
rewrite ^(.*)\?.*$ $1 break;
root /var/www/myapp;
expires 1y;
add_header Cache-Control "public, immutable";
}这样 /static/js/app.js?v=3.4.5 和 /static/js/app.js 都会命中同一个物理文件，版本号对服务端无意义，也就“被隐藏”了。
配合构建工具，彻底不用查询参数式版本号
更推荐的做法是从源头避免带参版本号。现代前端构建工具（如 Webpack、Vite、Rollup）支持文件内容哈希命名，例如生成 main.a1b2c3d4.js。此时 URL 本身已含唯一标识，无需额外加 ?v=xxx：
- 构建输出：将
main.js→main.a1b2c3d4.js - HTML 中引用：
<script src="/static/js/main.a1b2c3d4.js"></script> - Nginx 配置只需常规静态服务，无需处理查询参数
这种方案下，版本信息内嵌在文件名里，既可缓存又天然“无参”，比 query 版本更健壮、更利于 CDN 和浏览器缓存。
禁止 Nginx 返回带版本号的重定向或错误页
有时版本号会意外出现在 301/302 重定向 Location 头，或 404 错误页链接中。检查是否启用了自动索引或未配置的 fallback：
- 关闭目录列表：
autoindex off; - 避免使用
try_files $uri $uri/ /index.html;时把带参 URL 错误透传到后端 - 若用 Vue/React 的 history 模式，确保
try_files不把?v=xxx当作路径一部分转发
必要时可在 error_page 404 自定义页面中硬编码无参链接，防止模板渲染出带参 URL。
用 add_header 控制客户端行为，弱化版本感知
即使 URL 带参，也可通过响应头降低其影响：
location ~ \.(js|css|png|jpg|gif)$ {
root /var/www/myapp;
expires 1y;
# 告诉浏览器：这个资源不会变，别因参数不同就重复请求
add_header Cache-Control "public, immutable";
# 可选：禁止 Referer 泄露版本号（针对敏感场景）
add_header Referrer-Policy "no-referrer-when-downgrade";
}immutable 是关键——它让浏览器知道该资源在过期前绝不会更新，即使 URL 参数变化也不会重新验证，相当于从客户端层面“忽略版本号差异”。
