Go 模块代理返回 410 和 404 有什么不同

排查 Go 依赖下载时，看到 404 Not Found 和 410 Gone 很容易产生误判：前者像是地址写错，后者像是模块被永久删除。对 GOPROXY 来说，两者首先承担的是同一个控制信号——当前代理没有提供这个模块或资源，go 命令可以继续尝试后面的来源。默认配置是 https://proxy.golang.org,direct，所以 404 和 410 通常都会让流程继续。

404 和 410 在模块下载中先看“是否回退”

HTTP 语义上，404 是“没有找到”，410 是“资源已不存在或不再提供”。但 Go 的模块代理协议把它们都定义为“这个代理没有可用结果”的可回退状态。假设环境变量写成：

# 逗号表示：只有代理明确返回 404/410 时才继续下一个来源
GOPROXY=https://proxy.corp.example.com,https://proxy.golang.org,direct

# 检查当前实际配置，避免只看 shell 配置文件
go env GOPROXY

企业代理对某个模块返回 410 时，Go 仍可以访问公共代理；返回 404 时也一样。区别更多是代理维护者给人的语义提示：404 常用于“当前没有这项”，410 常用于“明确不再提供”。客户端决策不要只根据这两个数字分叉。

先定位是列表、元数据还是压缩包请求失败

模块代理不是只请求一个 URL。解析 @latest 可能先访问 @v/list 或 @v/@latest；确定版本后，还会读取 .info、.mod 和 .zip。同样的 404/410，落在不同资源上，修复动作并不一样：

建议用最小命令打开请求日志。下面的模块名和版本只是示例，替换成实际依赖；命令输出属于排查线索，不要把某一次网络结果当成协议结论。

# -x 打印 go 命令访问的代理和 VCS 请求，便于确认是否真的发生回退
GOPROXY=https://proxy.corp.example.com,https://proxy.golang.org,direct \
  go mod download -x golang.org/x/text@v0.3.2

# 只想检查代理变量时，不要把私有令牌写入日志或文章
go env GOPROXY GOPRIVATE GONOPROXY

逗号和竖线决定哪些错误可以继续

GOPROXY 中的分隔符比 404 和 410 的数字差异更值得关注。逗号分隔时，Go 对 404/410 回退，其他 HTTP 错误通常作为终止错误；竖线分隔时，后续来源还会接管超时等更多错误。

因此，私有代理返回 403 可能是有意的许可证、权限或安全策略；这时直接切到公共源，既不能解决认证，也可能造成不该外发的模块路径。生产环境优先确认代理的状态码设计、GOPRIVATE 和 GONOPROXY，再决定是否用竖线扩大容错。

修复后用同一条链路反向确认

如果只看到 404/410，先确认模块路径和版本是否写对；如果日志显示回退到了不该访问的公共源，检查私有模块匹配规则；如果是 403、500 或持续超时，先处理代理权限、上游健康度或网络策略。修复后再次运行 go mod download -x，确认请求是否命中预期代理，并检查模块是否进入本地缓存。

一个实用判断是：404/410 说明“这个来源没有结果”，不等于“模块一定不存在”；当后续源成功返回时，依赖本身可以完全正常。只有所有允许的来源都没有结果，或最后出现终止错误时，才需要继续查模块路径、版本标签和访问权限。

相关问题

Go 的 GOPROXY 默认会访问哪里？

默认通常是 https://proxy.golang.org,direct：公共代理没有返回可用结果时，再尝试直接访问版本控制仓库。

把逗号改成竖线一定更可靠吗？

不一定。竖线能跨过更多临时错误，但也可能绕过企业代理本来想阻断的 403；是否使用取决于数据边界和故障策略。

为什么改了 GOPROXY 仍然没有重新请求？

Go 会使用模块缓存。可以先确认目标版本是否已经存在于缓存，再用 go mod download -x 看是否确实发出了新的代理请求。