artifactory 作 go 代理需配置 goproxy 为 https://artifactory.example.com/artifactory/api/go/your-go-repo-name（末尾无斜杠），且必须创建 go 类型远程仓库；启用 gosumdb 需额外配置 gochecksum 类型仓库并指向其 api 路径。
go env 里 GOPROXY 设成 Artifactory 地址就行，但必须带 /go 后缀
Artifactory 不是普通 HTTP 代理，它把 Go 模块代理功能挂在一个子路径下。如果只配 https://artifactory.example.com，go get 会 404 —— 因为 Go 客户端默认请求的是根路径下的 /proxy/golang.org 这类地址，而 Artifactory 要求走 /go/...。
正确做法是把 GOPROXY 设为：https://artifactory.example.com/artifactory/api/go/<em>your-go-repo-name</em>。注意末尾不加斜杠，且 your-go-repo-name 必须是 Artifactory 里已创建的 Go 类型远程仓库（Remote Repository），不是通用代理仓库。
- Artifactory 管理后台 → Repositories → Add New Repository → Remote Repository → Package Type 选
Go - Remote URL 填官方镜像，比如
https://proxy.golang.org或https://goproxy.cn，不能留空 - Repository Key 就是上面 URL 里
your-go-repo-name的值，比如叫go-proxy - 设完后立刻
go env -w GOPROXY=https://artifactory.example.com/artifactory/api/go/go-proxy
启用 GOSUMDB 时，Artifactory 需单独配置 GoChecksum 仓库
Go 默认校验模块哈希（GOSUMDB=sum.golang.org），但 Artifactory 不自动代理 checksum 请求。直接复用同一个 Go 远程仓库会失败，go get 报错：verifying github.com/some/pkg@v1.2.3: checksum mismatch。
必须新建一个类型为 GoChecksum 的远程仓库，Remote URL 设为 https://sum.golang.org（或国内替代如 https://goproxy.cn），再在 GOSUMDB 里指向它：
立即学习“go语言免费学习笔记（深入）”；
- 新建 Remote Repository，Package Type 选
GoChecksum - Remote URL 填
https://sum.golang.org，Repository Key 记作go-checksum - 执行
go env -w GOSUMDB="https://artifactory.example.com/artifactory/api/go/go-checksum" - 别漏掉
GOINSECURE：如果 Artifactory 是 HTTP 或自签名 HTTPS，还得加go env -w GOINSECURE="artifactory.example.com"
go build 本地依赖没走代理？检查 replace 和 exclude 是否绕过了代理
Artifactory 只代理远程模块（go.mod 里没被 replace 或 exclude 掉的）。如果项目里写了 replace github.com/foo/bar => ./local/bar，那 go build 根本不会连 Artifactory —— 这不是 bug，是 Go 的设计逻辑。
常见误判场景：
- CI 构建失败，但本地
go build成功 → 很可能是本地有replace指向本地路径，CI 机器没有该目录 - 私有模块 401 → Artifactory 的 Go 远程仓库没开「Propagate Authentication」，或者 Token 没传给
go命令（需配~/.netrc或环境变量ARTIFACTORY_USER/ARTIFACTORY_KEY） - 模块版本解析异常（比如拉到
v0.0.0-20220101000000-abc123）→ Artifactory 的 Go 远程仓库没启用「Bypass Head Requests」，导致无法正确识别语义化版本
调试连不上 Artifactory？先看 go list -m -json all 输出和网络日志
go list 会真实触发模块解析和代理请求，比 go get 更安静、更底层。它输出 JSON，字段 Origin.URL 能确认当前模块实际从哪拉的 —— 如果还是 https://proxy.golang.org，说明 GOPROXY 没生效或被其他配置覆盖。
加 -v 和 GOROOT/src/cmd/go/internal/modfetch 相关日志能定位卡点：
- 运行
go list -m -json all 2>&1 | grep -i artifactory，看有没有请求发出 - 设环境变量
GODEBUG=http2debug=2，观察 HTTP 请求是否发到了 Artifactory 地址 - Artifactory 后台 → Admin → Monitoring → Request Logs，筛选
GET /artifactory/api/go/...，确认请求是否到达、返回码是多少 - 别忽略 DNS 和 TLS：用
curl -v https://artifactory.example.com/artifactory/api/go/go-proxy/github.com%2Fgolang%2Fnet/@v/list手动测通路
Artifactory 的 Go 代理行为高度依赖仓库类型和路径拼接规则，少一个 /go/、多一个斜杠、类型选错，都会静默失败。调的时候盯着 URL 和返回状态码，比看文档更快。
