Nginx集群中静态文件需外部机制保障一致性，推荐软链接+版本目录+校验拉取方案：构建产物写入时间戳目录，生成SHA256清单，节点定时比对并分块拉取，校验后原子软链切换；中小集群可用rsync+sersync。
Java 应用在 Nginx 集群中部署时，静态文件（如 HTML、CSS、JS、图片）通常不走 Java 服务，而是由 Nginx 直接提供。但多个 Nginx 节点之间**不会自动同步这些文件**——你必须在集群层面主动保障它们物理一致、版本可信、切换无感。
核心原则：Nginx 只读本地，一致性靠外部机制
Nginx 本身没有文件广播或跨节点同步能力。所谓“同步”，本质是让所有 Nginx 节点的 /var/www/static（或你配置的 alias/root 目录）内容完全相同，并在更新时原子生效。不能依赖各节点单独 git pull 或手动上传。
推荐方案：软链接 + 版本目录 + 校验拉取（适合生产）
这是上百台节点也能稳定运行的方式，兼顾一致性、可回滚和故障容忍：
- 每次发布，将构建产物（含哈希文件名）完整写入带时间戳的独立目录，例如：/data/static-v20260820-1400/
- 生成该目录下所有文件的 SHA256 清单，上传至轻量元数据服务（如 HTTP API）
- 各 Nginx 节点定时（如每 30 秒）请求元数据，比对本地目录哈希；仅当不一致时，才用 HTTP Range 分块拉取缺失或损坏文件
- 全部校验通过后，执行 ln -sf /data/static-v20260820-1400 /data/current —— 这是原子操作，毫秒完成，Nginx 配置始终指向 /data/current，无需 reload
- 保留至少两个历史版本目录，回滚只需改一次软链
简化方案：rsync + sersync（中小集群适用）
如果节点数在 20 台以内，且信任主发布机网络与权限，可用更轻量方式：
立即学习“Java免费学习笔记（深入）”；
- 在发布机安装 sersync + inotify-tools，监控构建输出目录（如 /opt/build/dist）
- 配置 sersync.xml，目标为所有 Nginx 节点 IP，使用 rsync -a --delete --exclude='.git' 确保精准一致
- 所有目标节点开通 SSH 免密登录，或部署 rsync daemon
- 启动 sersync 后，源端任何增删改都会在 1–3 秒内同步到全部节点
补充关键点：配合 Java 部署与缓存策略
静态文件同步只是基础，还需协同 Java 服务与缓存行为：
- URL 版本化：构建时给 JS/CSS 文件名注入内容哈希（如 app.a1b2c3d4.js），HTML 中直接引用。这样即使旧文件残留，浏览器和 CDN 也只会请求新路径，天然规避缓存不一致
-
Nginx 配置统一：所有节点的 location 块保持一致，例如：
location /static {
alias /data/current/;
expires 1h;
add_header Cache-Control "public, immutable";
} - 避免动态覆盖：禁止在运行中直接往 /data/current 写文件。所有变更必须经版本目录+软链流程，防止部分节点写一半就响应请求
