讲师中心 微信公众号
AI工具推荐 视频效率加速

Golang go mod download 失败的常见原因与DNS配置关系

雨芳同学_5581

雨芳同学_5581

发布时间:2026-02-12 13:20:39

|

411人浏览过

|

来源于php中文网

原创

DNS解析失败导致go mod download报错,需先验证proxy.golang.org能否解析,再检查GOPROXY设置是否正确、环境变量是否生效,最后处理sum.golang.org校验问题。

golang go mod download 失败的常见原因与dns配置关系

go mod download 报错 lookup proxy.golang.org: no such host 是 DNS 解析失败

这不是 Go 本身的问题,而是你的本地 DNS 无法解析 proxy.golang.org 或 sum.golang.org。国内常见情况是运营商 DNS(如 114.114.114.114)直接返回 NXDOMAIN,或中间被劫持/缓存污染。

  • 先验证:运行 dig proxy.golang.org +short 或 nslookup proxy.golang.org,看是否返回 IP;若为空或报错,就是 DNS 层面没通
  • 别急着换代理——如果 DNS 都解析不了,设 GOPROXY 也白搭,因为 Go 还是得先查域名
  • 临时测试可改用公共 DNS,比如 1.1.1.1 或 8.8.8.8(Linux/macOS 改 /etc/resolv.conf,Windows 在网络适配器里手动填)

设置了 GOPROXY 但依然走原始域名,说明环境变量没生效

go mod download 会严格按顺序检查:先看 GOPROXY,再 fallback 到 direct(即直连官方域名)。如果你看到日志里出现 GET https://proxy.golang.org/... 失败,但后续又尝试 https://goproxy.io/... 或直接 https://github.com/...,大概率是 GOPROXY 值写错了或没加载。

  • 确认值是否含协议和尾部斜杠:export GOPROXY=https://goproxy.cn ✅,export GOPROXY=goproxy.cn ❌(缺 https://)
  • 检查是否被其他脚本覆盖:在执行 go mod download 前加一句 echo $GOPROXY,确保输出是你设的地址
  • Windows 用户注意:PowerShell 和 CMD 的环境变量设置方式不同,$env:GOPROXY="https://goproxy.cn"(PS)和 set GOPROXY=https://goproxy.cn(CMD)不互通

go mod download 卡在某个 module,可能是 sumdb 校验失败触发 DNS 回退

Go 默认启用校验和数据库(sum.golang.org),即使你设了 GOPROXY,它仍会单独请求 sum.golang.org 做完整性校验。一旦这个域名解析失败,整个 download 就会卡住或报 verifying ...: checksum mismatch。

Adblock Dns
Adblock Dns

在你的机器上运行DNS服务器,使用Pi-hole黑名单阻止189,000+个广告、追踪器和恶意软件域名,实现全网拦截。

下载
  • 快速绕过:加 -insecure 参数(仅调试用)go mod download -insecure,但这会跳过所有校验,不推荐长期使用
  • 稳妥做法:把 sumdb 也代理掉,设 GOSUMDB=off(完全关闭)或 GOSUMDB=sum.golang.org+https://goproxy.cn/sumdb(部分镜像支持,如 goproxy.cn)
  • 注意:某些私有模块或企业内部 proxy 不提供 sumdb 接口,此时必须关掉校验,否则下载必然中断

公司内网或 CI 环境里 go mod download 失败,常因 DNS 策略隔离

很多企业 DNS 不允许解析外部域名,或者只放行特定白名单(比如只许查 github.com,但拦了 proxy.golang.org)。这时候改本地 resolv.conf 没用,因为 DNS 请求根本出不去。

立即学习“go语言免费学习笔记(深入)”;

  • 优先联系运维:确认是否开放了 proxy.golang.org、sum.golang.org、gocenter.io 等常用代理域名
  • CI 脚本里别依赖 shell 配置文件(如 .bashrc),务必显式 export:export GOPROXY=https://goproxy.cn; export GOSUMDB=off
  • 极少数情况需要自建 DNS 转发规则,比如用 CoreDNS 把 *.golang.org 转给 1.1.1.1,而不是硬编码 hosts —— hosts 对 HTTPS SNI 不生效
事情说清了就结束。DNS 这层最容易被当成“网络问题”跳过去,但其实只要盯住 dig 和 echo $GOPROXY 两个命令,90% 的 go mod download 失败都能定位到根上。

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

539

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

616

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1236

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

791

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1826

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

5214

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2414

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

4266

2025.06.17

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn