net.JoinHostPort不自动包裹IPv6方括号，因它仅做简单拼接；正确做法是先用net.ParseIP解析并调.String()标准化（IPv6自动加括号），再传入JoinHostPort。
为什么 net.JoinHostPort 不能直接拼接带方括号的 IPv6 地址
当你传入类似 "2001:db8::1" 这样的纯 IPv6 地址字符串给 net.JoinHostPort，它会原样拼成 "2001:db8::1:8080" —— 这不是合法的网络地址格式，解析时会报 "address 2001:db8::1:8080: too many colons in address"。IPv6 地址在含端口时**必须加方括号**，即 "[2001:db8::1]:8080"。
根本原因：Go 的 net.JoinHostPort 设计上假设你传入的是「已标准化」的主机名或 IPv4 字符串；它不负责判断 IPv6 并自动包裹方括号。
- 它只做简单拼接：
host + ":" + port - 对 IPv6 地址不做任何识别或转义
- 若 host 已含方括号（如
"[::1]"），它仍会照常拼，结果变成"[::1]:8080"—— 这是合法的，但你得自己保证输入正确
安全拼接的正确做法：先标准化主机再调用 net.JoinHostPort
真正安全的方式，是把原始主机字符串交给 net.ParseIP 解析，再用 IP.String() 获取标准格式（IPv6 自动带方括号），最后喂给 net.JoinHostPort。
示例：
host := "2001:db8::1"
port := "8080"
ip := net.ParseIP(host)
if ip == nil {
// 处理非法 IP，比如域名或空值
log.Fatal("invalid host")
}
safeHost := ip.String() // → "[2001:db8::1]"
addr := net.JoinHostPort(safeHost, port) // → "[2001:db8::1]:8080"
- 对 IPv4（如
"192.168.1.1"）：ip.String()返回原样，不影响拼接 - 对 IPv6（无论是否带括号、是否压缩）：
ip.String()总返回标准带括号格式 - 对域名（如
"example.com"）：net.ParseIP返回nil，需单独处理（见下一点）
遇到域名或不确定输入时，怎么统一处理
如果 host 可能是域名、IPv4、IPv6 或带括号的 IPv6，不能无脑 ParseIP，否则域名会被判失败。此时应分情况判断：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先尝试
net.ParseIP(host)：成功则用其String()标准化 - 失败则认为是域名或非法输入：直接使用原始
host（域名无需括号） - 注意：若原始 host 已含方括号（如
"[::1]"），ParseIP("[::1]")仍会成功，且String()返回相同格式，不会重复加括号
简明逻辑：
func safeJoin(host, port string) string {
if ip := net.ParseIP(host); ip != nil {
host = ip.String()
}
return net.JoinHostPort(host, port)
}
这个函数能安全处理 "localhost"、"127.0.0.1"、"::1"、"[2001:db8::1]" 所有情况。
别忽略的边界：空 host、端口非数字、以及 Listen 的实际兼容性
net.JoinHostPort 本身不校验 port 是否为有效端口号（比如 "abc" 或 "65536"），这些错误要到 net.Listen 阶段才暴露，报错如 "listen tcp: address abc: invalid port"。
- 建议在拼接前用
strconv.Atoi检查 port 是否为 1–65535 范围内的整数 - host 为空字符串时，
net.JoinHostPort("", "8080")返回:8080，等价于监听所有接口，在服务端常用，但需确认是否符合你的安全策略 - 某些旧版系统或容器环境对 IPv6 方括号地址支持不稳定，若部署后连接失败，先确认底层
net.Listen是否真收到了"[::1]:8080"这类地址
最易被跳过的点：你以为传了 IPv6 就万事大吉，但没验证 ParseIP 成功与否，也没拦截超大端口号 —— 结果服务启动时 panic，而不是清晰报错。
