Go 1.25 go vet hostport 怎么提前发现 IPv6 地址拼接错误：从 fmt.Sprintf 到 net.JoinHostPort

线上服务把目标主机从域名切到 IPv6 地址后，原本能工作的拨号代码突然在测试环境报错。问题不在端口，而在把 host 和 port 直接拼成了 [2001:db8::10]:8443 之外的另一种形式。Go 1.25 的 go vet hostport 能在真正调用 net.Dial 前指出这类风险，修复点通常是把 fmt.Sprintf 换成 net.JoinHostPort。

只要地址要交给 net.Dial、net.Listen 等网络 API，就让 net.JoinHostPort 负责方括号和冒号；go vet hostport 负责把遗漏尽早拦在检查阶段。

错误现场：IPv4 通过，IPv6 在拨号前暴露

先看一个很容易被代码审查放过的辅助函数。它把配置里的主机和端口变成拨号地址，测试只覆盖了 127.0.0.1，因此一直显得正常。

package main

import (
    "fmt"
    "net"
)

func dialAddress(host string, port int) (net.Conn, error) {
    address := fmt.Sprintf("%s:%d", host, port)
    return net.Dial("tcp", address)
}

当 host 是 127.0.0.1 时，结果是 127.0.0.1:8443；换成 2001:db8::10 后，冒号数量不再能让解析器判断哪里是主机、哪里是端口。规范的 IPv6 文字地址需要用方括号包住主机部分，否则错误可能延迟到真实拨号或配置切换时才出现。

先让 go vet hostport 把风险定位到调用点

在使用 Go 1.25 的工具链中，进入模块根目录执行：

go vet ./...

新分析器会关注把类似 fmt.Sprintf("%s:%d", host, port) 生成的字符串传给 net.Dial 的路径。它的价值不是替代运行测试，而是把“只在 IPv6 才出问题”的隐患提前变成可读的静态检查结果。

图中只保留正文真实出现的三个节点：fmt.Sprintf 产生未经地址族处理的字符串，net.JoinHostPort 生成带方括号的安全地址，最后交给 net.Dial。它表达的是调用链和输入输出差异，不是一个泛化的网络架构图。

把地址构造改成一个明确的边界函数

修复时不必在每个调用点手写判断 IPv4 或 IPv6。让标准库函数统一处理：

func dialAddress(host string, port int) (net.Conn, error) {
    address := net.JoinHostPort(host, strconv.Itoa(port))
    return net.Dial("tcp", address)
}

完整代码还需要补上 strconv 导入。注意传给 net.JoinHostPort 的 host 应该是裸地址，例如 2001:db8::10，不要提前写成 [2001:db8::10]。如果配置层已经带方括号，应该在配置校验处统一清理或拒绝，而不是让每个调用方猜输入格式。

这个函数的边界也很清楚：它只负责构造 endpoint，不负责判断服务是否监听、DNS 是否可达或 TLS 是否握手成功。

用双栈表格测试核对修复结果

静态检查通过后，补一个不依赖远端服务的字符串测试，把三种输入明确写下来：

func TestDialAddress(t *testing.T) {
    cases := []struct {
        name, host, want string
    }{
        {"ipv4", "127.0.0.1", "127.0.0.1:8443"},
        {"ipv6", "2001:db8::10", "[2001:db8::10]:8443"},
        {"hostname", "api.example.com", "api.example.com:8443"},
    }
    for _, tc := range cases {
        t.Run(tc.name, func(t *testing.T) {
            got := net.JoinHostPort(tc.host, "8443")
            if got != tc.want {
                t.Fatalf("got %q, want %q", got, tc.want)
            }
        })
    }
}

可见成功状态是三组子测试都通过，并且 IPv6 这一行明确出现方括号。不要把 net.Dial 直接连到一个公共地址来证明格式正确，那会把网络波动混进单元测试。

把 hostport 检查接进发布前流程

如果项目已有 Makefile，可以把检查和测试排成同一条本地命令：

check:
    go vet ./...
    go test ./...

在 CI 中先跑 go vet ./...，再跑测试。这样新增的拼接代码会先被 hostport 分析器拦住；旧版本工具链没有这个分析器时，仍保留双栈测试作为兼容期兜底。若仓库明确固定了工具链版本，不要为了一个检查临时替换整个构建环境。

第二张图绑定发布流程中的真实状态：go vet hostport 先检查 net.Dial 地址构造，IPv6 测试再验证输出，最终进入“修复后”状态。每个标签都能在本节命令或前文测试中找到。

常见问题：几个容易混淆的边界

为什么 IPv4 测试全绿仍不够

IPv4 只有一个主机冒号，字符串拼接恰好符合常见写法；IPv6 地址自身包含多个冒号，所以必须由标准库负责分隔。

已经有方括号还要不要再 Join

不要把带方括号的 host 再直接传给多个格式化层。配置输入应约定为裸 host，统一在 endpoint 构造函数中调用 net.JoinHostPort。

go vet 通过就代表网络一定可用吗

不代表。go vet hostport 只检查一类地址拼接风险；监听状态、路由、防火墙、DNS 和 TLS 仍需各自验证。

收尾检查清单

• 搜索网络拨号代码里是否还有 fmt.Sprintf("%s:%d"。
• 统一让 net.JoinHostPort 接收裸 host 和字符串端口。
• 执行 go vet ./...，确认 hostport 风险不再出现。
• 用 IPv4、IPv6 和域名三组输入跑测试。