安全拆分 host:port 应先用 net.SplitHostPort 剥离方括号和端口,再用 net.ParseIP 校验 IP;若为 nil 则需 DNS 解析,且必须判空防 panic。
Go 的 net 包处理 IP 地址,核心不是“万能解析”,而是“职责分离”:用 net.ParseIP 专做地址校验,用 net.SplitHostPort 专拆带端口的字符串,用 net.LookupIP 和 net.LookupAddr 分别做正向/反向 DNS 查询——混用或跳过判空,90% 的问题就出在这儿。
如何安全拆分 “host:port” 并提取有效 IP?
用户输入如 "[::1]:8080" 或 "192.168.1.10:3000",不能直接丢给 net.ParseIP,它不认端口,更不认方括号。
-
net.SplitHostPort是唯一正确入口:它自动识别 IPv6 方括号,把"[::1]:8080"拆成 host ="::1"、port ="8080" - 拆出的
host再喂给net.ParseIP——这时才真正做地址合法性校验 - 若
net.ParseIP(host)返回nil,说明是域名(如"localhost"),不是 IP,后续需走net.LookupIP解析 - 永远检查错误:
if ip == nil { /* 拒绝监听或报错 */ },否则监听"invalid:8080"会 panic
为什么遍历 net.Interfaces() 常拿到 127.0.0.1 或重复 IP?
因为系统有多个接口(Docker 虚拟网卡、Wi-Fi、以太网、vEthernet),而 net.Interfaces() 不区分主次,也不查路由表。
- 必须过滤:
iface.Flags & net.FlagUp != 0(只取启用状态)、!ip.IsLoopback()(剔除回环)、ip.To4() != nil(只留 IPv4) - 若有多张活跃网卡(比如笔记本同时连了 Wi-Fi 和 USB 网络共享),第一个非回环 IPv4 很可能不是你期望的出口 IP
- 真要拿“默认路由出口 IP”,得用 UDP 拨号法:
conn, _ := net.Dial("udp", "8.8.8.8:53"),再取conn.LocalAddr().(*net.UDPAddr).IP——它依赖系统路由决策,更贴近真实通信路径 - 离线环境该方法失效,务必 fallback 到接口遍历,并加日志提示“未联网,返回首个可用局域网 IP”
net.LookupIP 和 net.LookupAddr 别用反了
这是新手最高频误用:拿 net.LookupHost("1.1.1.1") 想查域名,结果返回 ["1.1.1.1"] ——它根本没查 PTR 记录,只是把 IP 当作主机名原样返回。