根本原因是Go工具链将带端口的域名（如gitlab.example.com:8081）视为不合规host而拒绝访问，解决需配置Git URL重写、GOPRIVATE/GONOPROXY/GONOSUMDB三者协同，并优先采用SSH协议避开TLS校验问题。
go mod download 报 unknown revision 或 module not found
根本原因不是 Go 不支持非标准端口，而是 go 工具链在解析模块路径时，会把 gitlab.example.com:8081 这类带端口的域名当成「不合规 host」，默认拒绝访问——尤其当它出现在 go.mod 的 module 声明里或 import 路径中时。
常见现象：
-
go mod tidy卡住，最后报unknown revision或module github.com/xxx/yyy@latest found, but does not contain package xxx -
go list -m all显示该模块路径，但版本为空或为(devel) - 手动
git clone http://gitlab.example.com:8081/group/lib.git能成功，但go mod download失败
关键点在于：Go 模块路径必须能被映射到一个可访问的 Git URL，而默认情况下它只信任标准 HTTPS 端口（443）和 HTTP 端口（80）上的域名。
解决办法是让 Git 层面完成协议和端口重写，而不是靠 Go 配置硬扛：
立即学习“go语言免费学习笔记（深入）”；
- 运行
git config --global url."http://gitlab.example.com:8081/".insteadOf "https://gitlab.example.com/"（注意末尾斜杠） - 确保你的
go.mod中module行写的是gitlab.example.com/group/lib，不是gitlab.example.com:8081/group/lib - 所有
import语句也用gitlab.example.com/group/lib，而非含端口的变体
GOPRIVATE 和 GONOPROXY 必须同时配对使用
只设 GOPRIVATE=gitlab.example.com 不够，go 仍可能尝试走代理去查 checksum，结果因端口问题失败。必须同步告诉 Go：这个域名既不走代理，也不校验 sumdb。
执行以下两条命令（顺序无关）：
go env -w GOPRIVATE=gitlab.example.comgo env -w GONOPROXY=gitlab.example.comgo env -w GONOSUMDB=gitlab.example.com
注意：GONOPROXY 和 GONOSUMDB 是独立开关，漏掉任一都会导致不同阶段失败：
- 缺
GONOPROXY→go mod download仍尝试连goproxy.cn查私有模块，返回 404 - 缺
GONOSUMDB→ 即使下载成功，go build时校验 checksum 会连sum.golang.org，超时或 403
HTTPS 证书问题导致 dial timeout 或 x509 error
自建 GitLab 若用自签名证书或未配通域名（比如直接用 IP + 端口），go mod 会因 TLS 校验失败卡住，错误可能是 x509: certificate signed by unknown authority 或 context deadline exceeded。
不要用 GOINSECURE 全局放行——它只对 HTTP 有效，对 HTTPS + 自签名无效。正确做法是：
- 如果用 HTTPS 协议访问（如
https://gitlab.example.com:8081），需把 GitLab 的 CA 证书加到系统信任链，或设置git config --global http."https://gitlab.example.com:8081/".sslCAInfo /path/to/ca.crt - 更推荐改用 SSH：生成密钥、添加到 GitLab、并在
~/.gitconfig中配置[url "git@gitlab.example.com:"] insteadOf = https://gitlab.example.com/ - SSH 方式下，
go完全复用 Git 的认证逻辑，跳过 TLS 校验，且支持非标准端口（只要 SSH daemon 监听对应 port）
replace 不能替代正确的模块路径声明
有人试图绕过端口问题，在 go.mod 里写 replace gitlab.example.com/group/lib => ./local-lib，但发现 go build 仍失败。这是因为 replace 只在模块解析完成后生效，而模块路径本身（即 go.mod 第一行的 module）必须合法可解析。
也就是说：
-
module行不能含端口，也不能是 IP 地址（如192.168.1.100:8081/group/lib） -
replace左侧必须与module声明完全一致（包括大小写、斜杠方向） -
replace右侧路径必须存在且含有效go.mod，否则go mod tidy会报错
真正要改的只有 Git 的 URL 映射和 Go 的环境变量，不是代码里的路径字符串。
