Go模块依赖下载失败的完整解决方案
一句话总结：通过设置稳定的中国Go代理、完全清理模块缓存，并使用go get -d策略重新下载依赖，成功解决了网络连接不稳定导致的Go模块依赖问题。
问题背景
在开发Go项目时，遇到了github.com/c-bata/go-prompt库无法下载的问题。这是一个关键的交互式命令行库，无法轻易替代。项目使用插件化架构，debug_lib模块依赖此库实现调试控制台功能。
错误表现
初始错误
go mod tidy
go: finding module for package github.com/c-bata/go-prompt
go: debug_lib imports
github.com/c-bata/go-prompt: module github.com/c-bata/go-prompt@latest found (v0.2.6), but does not contain package github.com/c-bata/go-prompt
网络连接错误
GOPROXY=direct GOSUMDB=off sh tidy.sh
go: finding module for package github.com/c-bata/go-prompt
fatal: unable to access 'https://github.com/c-bata/go-prompt/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443
SSH配置错误
Host key verification failed.
fatal: Could not read from remote repository.
问题分析
经过深入分析，发现问题的根本原因是：
网络连接不稳定：到GitHub的HTTPS连接经常超时或中断
代理服务问题：
proxy.golang.org在中国大陆访问不稳定
goproxy.cn可能缓存不完整或版本同步延迟
Go模块缓存损坏：由于网络中断导致本地缓存的模块数据不完整
SSL/TLS连接问题：LibreSSL在连接GitHub时出现系统调用错误
尝试的解决方案
方案一：使用SSH替代HTTPS（失败）
git config --global url."git@github.com:".insteadOf "https://github.com/"
结果：遇到SSH密钥验证问题
方案二：禁用SSL验证（失败）
git config --global http.sslVerify false
结果：仍然出现连接超时
方案三：使用GitHub镜像（失败）
git config --global url."https://hub.fastgit.xyz/".insteadOf "https://github.com/"
结果：镜像站同样连接失败
方案四：手动vendor模式（部分成功）
尝试使用go mod vendor，但由于go.sum文件缺失大量条目而失败。
最终成功方案
步骤1：设置多重代理备份
export GOPROXY=https://goproxy.cn,https://goproxy.io,direct
export GOSUMDB=sum.golang.google.cn
关键点：
使用多个中国代理作为备份
direct作为最后的fallback
设置中国的校验和数据库
步骤2：彻底清理Go缓存
go clean -modcache && go clean -cache
重要性：清除所有损坏的模块缓存和构建缓存
步骤3：使用正确的下载策略
cd debug_lib
go get -d github.com/c-bata/go-prompt@v0.2.6
go build .
关键参数：
-d标志：只下载不安装，避免安装阶段的问题
明确指定版本号：@v0.2.6
步骤4：验证整个项目
cd ..
sh tidy.sh # 运行项目的整体依赖整理脚本
技术细节说明
为什么-d标志很重要
go get -d标志告诉Go只下载模块到缓存，不执行安装过程。这样可以：
避免在不完整下载时触发构建错误
减少网络传输中断的影响
让后续的go build能正确找到依赖
代理设置的优先级
GOPROXY=https://goproxy.cn,https://goproxy.io,direct
首先尝试goproxy.cn（速度快）
失败后尝试goproxy.io（备用）
最后使用direct（直连源站）
缓存清理的必要性
Go模块系统在网络中断时可能产生：
不完整的模块数据
损坏的校验和信息
错误的版本映射
完全清理缓存可以避免这些问题。
预防措施
1. 配置稳定的代理环境
在~/.zshrc或~/.bashrc中添加：
export GOPROXY=https://goproxy.cn,https://goproxy.io,direct
export GOSUMDB=sum.golang.google.cn
2. 定期清理缓存
# 创建清理脚本
echo '#!/bin/bash
go clean -modcache
go clean -cache
echo "Go缓存已清理"' > ~/clean-go-cache.sh
chmod +x ~/clean-go-cache.sh
3. 使用稳定的网络环境
避免在网络不稳定时进行依赖更新
考虑使用企业级网络或VPN
总结
这次问题的解决关键在于：
正确的代理配置：使用多重备份代理
彻底的缓存清理：避免使用损坏的缓存数据
合适的下载策略：使用-d标志分步下载
系统性的验证：确保整个项目构建成功
Go模块系统虽然强大，但在网络环境不稳定的情况下容易出现各种问题。通过本文的方法，可以有效解决大部分Go依赖下载问题。
环境信息：
Go版本：1.21
操作系统：macOS
网络环境：中国大陆
项目类型：大型多人在线游戏服务器（插件化架构）