代理缓存不一致的本质是本地或中间代理缓存了过期的元数据（如index.json、manifest、go.mod等）而未及时同步上游变更，导致拉取错误版本；需针对性清理缓存、绕过缓存或调整代理配置。
代理缓存不一致导致拉错版本，本质是本地或中间代理（如 Nexus、Artifactory、npm registry 镜像、Go proxy、Docker registry mirror）缓存了过期的元数据（index.json、go.mod、manifest、package-lock.json 等），却未及时同步上游变更。这不是网络问题，也不是权限问题，而是“缓存没刷新” —— 你拉到的不是最新版，而是代理认为“还新鲜”的旧版。
为什么 npm install 总是装旧版包？查 registry 和 cache 两层
npm 默认会优先读本地缓存 + 配置的 registry 缓存，而非实时校验远端。常见现象：npm install lodash@4.17.21 却装了 4.17.20，或 npm outdated 显示有新版本但 install 不生效。
- 先确认当前 registry：运行
npm config get registry，如果是国内镜像（如https://registry.npmmirror.com），它可能滞后于 npmjs.org - 清本地缓存：执行
npm cache clean --force（注意：这不会删node_modules，只清元数据缓存） - 绕过缓存强制重读 registry：加
--no-cache参数，例如npm install lodash@4.17.21 --no-cache - 验证远端真实版本：直接 curl
https://registry.npmmirror.com/lodash或https://registry.npmjs.org/lodash，看dist-tags.latest和versions字段是否一致
Docker pull 拉到错误平台镜像？manifest 缓存是罪魁
在 Apple Silicon 上执行 docker pull nginx:alpine 却拿到 linux/amd64 镜像（启动失败报 exec format error），大概率是本地 ~/.docker/manifests/ 缓存了旧的 multi-arch manifest，且其中 linux/arm64 digest 指向已失效的 layer。
- 不要删整个
~/.docker，只需清理 manifest 缓存：rm -rf ~/.docker/manifests/*（Linux/macOS）或手动清空%USERPROFILE%\.docker\manifests\（Windows） - 拉取时显式指定平台可跳过自动选型歧义：
docker pull --platform linux/arm64 nginx:alpine - 若用
docker build --pull报sha256 digest verification failed，说明构建 cache 复用了损坏的 layer 元数据 —— 此时需docker builder prune -a或加--no-cache
Go mod download 总是卡在旧 commit？go.sum 和代理缓存双重干扰
执行 go mod download 后 go list -m all 仍显示旧版本，或 go build 报 checksum mismatch，往往因为：go.sum 锁定了旧 hash；或 GOPROXY（如 goproxy.cn）缓存了旧模块 zip 和 @v/list 元数据，未随 upstream 更新。
- 先清理本地模块缓存：
go clean -modcache（这是最有效一步，别跳过） - 临时禁用代理直连官方源验证：
GOPROXY=direct GOSUMDB=off go mod download - 检查模块真实发布状态：
curl https://proxy.golang.org/github.com/some/repo/@v/list，对比你本地go.sum中该模块的 hash 是否匹配最新行 - 若确认要升级，删掉
go.sum中对应行 +go mod tidy重新生成（谨慎操作，仅限调试）
私有 Maven/Nexus 仓库拉错 SNAPSHOT 版本？关键在 metadata.xml 过期
SNAPSHOT 版本每次部署应生成新 timestamped artifact，但 IDE 或 mvn clean install 仍引用旧 JAR，说明本地 ~/.m2/repository/ 下的 maven-metadata.xml 缓存未更新，或 Nexus 的 group repo 缓存策略设为“永不过期”。
- 强制更新本地 metadata：
mvn clean compile -U（-U即--update-snapshots） - 删本地对应模块下的
maven-metadata*.xml和_remote.repositories文件，再重试 - 登录 Nexus 控制台 → 对应 repository → Configuration → “Cache Configuration” → 调低
Not Found Cache TTL和Metadata Cache TTL（建议 ≤ 300 秒） - 若用
mvn deploy推送新 SNAPSHOT，确保settings.xml中 server 配置了<configuration><httpheaders><property><name>Cache-Control</name><value>no-cache</value></property></httpheaders></configuration>（部分 Nexus 版本需要）
所有代理缓存不一致问题，核心都落在“元数据 vs 内容”分离上：代理可以缓存 tar.gz，但必须实时同步 index、manifest、list、metadata 这类指挥调度文件。一旦这些文件滞后，你就永远不知道自己拉的到底是不是“最新版”。清理缓存不是权宜之计，而是必要调试动作 —— 尤其当你明确知道上游已发布新版，本地却纹丝不动时。
