Go net.LookupSRV 怎样解析服务发现记录的优先级与端口

做服务发现时，net.LookupSRV 已经替你完成了 SRV 查询名构造、结果过滤和排序。实用做法是：传入服务名、协议和域名，先检查错误，再读取每条记录的 Target、Port、Priority、Weight，最后用 net.JoinHostPort 生成连接地址。不要把 cname 直接当作服务端地址，也不要在拿到结果后再次按优先级打乱顺序。

先把 service、proto、name 传对

SRV 记录的常见查询名是 _service._proto.name。因此服务名写 api、协议写 tcp、域名写 example.com 时，标准库会查询 _api._tcp.example.com。proto 应使用 tcp 或 udp；如果服务和协议都传空字符串，才表示直接查询传入的自定义名称。

package main

import (
    "fmt"
    "net"
)

func main() {
    // service 和 proto 决定 _api._tcp.example.com 这一查询名。
    cname, records, err := net.LookupSRV("api", "tcp", "example.com")
    if err != nil {
        // DNS 失败时不要把空切片当成“没有服务”，先保留原始错误。
        fmt.Printf("SRV 查询失败: %v\n", err)
        return
    }
    fmt.Printf("owner name: %s, records: %d\n", cname, len(records))
}

cname 是第一条 SRV 应答的 owner name。通常它就是构造出来的查询名，但如果查询经过 CNAME 跳转，二者可能不同；它适合做诊断信息，不是最终要连接的目标。

四个字段决定“连哪台服务”

每个 *net.SRV 都有四个核心字段：Target 是目标主机，Port 是服务端口，Priority 是优先级，Weight 用于同优先级记录之间的选择。优先级数值越小越优先；同一优先级内，标准库会依据权重随机化返回顺序。

一个常见误区是只取第一条记录，然后把它当成永久固定节点。更稳妥的策略是保留整个结果集：优先尝试低优先级数值的记录，连接失败后再考虑同组或后续记录。是否重试、退避和熔断属于客户端策略，不能由 SRV 字段单独决定。

把 Target 和 Port 组合成可拨号地址

DNS 名称通常以点结尾，例如 node-1.example.com.。它是完整域名写法；如果下游连接库或日志规范不希望保留末尾点，可以在边界处去掉一个点，但不要用冒号拼接端口。net.JoinHostPort 能正确处理 IPv4、IPv6 和主机名。

package main

import (
    "fmt"
    "net"
    "strconv"
    "strings"
)

func srvAddresses(records []*net.SRV) []string {
    addresses := make([]string, 0, len(records))
    for _, record := range records {
        if record == nil || record.Target == "" || record.Port == 0 {
            // 忽略不完整记录，避免把空主机或零端口交给拨号层。
            continue
        }
        // 末尾点只在连接地址边界处理；SRV 的原始字段仍保持不变。
        host := strings.TrimSuffix(record.Target, ".")
        addresses = append(addresses, net.JoinHostPort(host, strconv.Itoa(int(record.Port))))
    }
    return addresses
}

func main() {
    _, records, err := net.LookupSRV("api", "tcp", "example.com")
    if err != nil {
        // 真实项目应把错误交给重试或降级策略，而不是继续使用旧结果。
        fmt.Println("lookup error:", err)
        return
    }
    fmt.Println(srvAddresses(records))
}

这里的 Port 是 uint16，转换为 int 后再交给 strconv.Itoa 即可。过滤空记录只是示例边界；如果业务必须保留完整诊断，应同时记录被丢弃的字段，而不是静默吞掉。

常见问题

LookupSRV 返回空切片但没有错误怎么办？

把它当作“当前查询没有可用 SRV 记录”处理，再决定是否使用配置文件或固定地址降级；不要凭空补一个默认端口。

为什么 cname 和查询名不一样？

标准库返回的是第一条 SRV 应答的 owner name。DNS 链路发生 CNAME 跳转时，owner name 可以变化，这不代表 Target 字段失效。

需要自己按 Weight 重新排序吗？

通常不需要。官方文档说明返回结果已按 Priority 排序，并在同一 Priority 内按 Weight 随机化；重新排序可能破坏服务发现端的意图。

实际落地时，把 SRV 查询、地址组合和后续拨号拆成三个边界：查询层保存错误，选择层尊重返回顺序，连接层负责超时、重试和回收。这样既能正确使用标准库的优先级与权重，也方便在 DNS 记录变化时更新节点。