Headless Service不分配ClusterIP，专为StatefulSet提供稳定DNS解析，使Go客户端能通过pod-name.service-name.namespace.svc.cluster.local直连指定Pod或service-name.namespace.svc.cluster.local获取全部Pod IP列表，实现节点发现与精准路由。
Headless Service 不是用来“暴露”服务给外部访问的，它根本不会分配 ClusterIP，也不走 kube-proxy 转发——你要的是让 Go 客户端在集群内直连 StatefulSet 的每个 Pod，而不是对外暴露端口。
为什么用 Headless Service 配合 Go 客户端连有状态集群
Go 应用（比如一个分布式协调器或分片客户端）需要知道所有后端 Pod 的真实 IP 和稳定 DNS 名，才能实现：节点发现、主从路由、分片亲和、故障隔离。ClusterIP 会掩盖真实拓扑，而 Headless Service 让 net.LookupHost 直接返回全部 Pod IP，或通过固定子域名（如 redis-0.redis-headless.default.svc.cluster.local）定向连接。
- StatefulSet 的每个 Pod 有唯一、稳定的主机名（
pod-name），Headless Service 是让这个主机名可 DNS 解析的前提 - Go 客户端必须用全限定域名（FQDN）发起连接，不能只写 service 名——否则 DNS 返回的是 A 记录列表，Go 的
net.Dial默认只取第一个，无法控制选哪个 Pod - 若需轮询或哈希路由，得自己解析
net.LookupHost结果，再选 IP；若需固定实例（如连 MySQL 主节点），就硬编码mysql-0.mysql-headless.default.svc.cluster.local
Go 代码里怎么安全解析 Headless Service 的 Pod 列表
别直接用 net.Dial("tcp", "redis-headless:6379") ——它可能随机连上任意一个 Pod，且 DNS TTL 或缓存会让结果过期。正确做法是显式调用 DNS 查询并做容错。
- 用
net.LookupHost("redis-headless.default.svc.cluster.local")获取全部 A 记录，返回[]string（每个是 Pod IP） - 如果要连特定序号 Pod，查
net.LookupHost("redis-0.redis-headless.default.svc.cluster.local")，确保返回单个 IP - 务必加超时和重试：
net.DefaultResolver.PreferGo = true避免 cgo 解析阻塞 goroutine；对每次 Dial 设置context.WithTimeout - 注意：Kubernetes DNS 默认不返回未就绪 Pod 的记录，除非你在 Service 中设了
publishNotReadyAddresses: true和 annotationservice.alpha.kubernetes.io/tolerate-unready-endpoints: "true"
StatefulSet + Headless Service YAML 关键字段不能漏
光写 clusterIP: None 不够，Go 客户端连不上是因为缺少命名绑定。StatefulSet 必须通过 serviceName 字段明确关联到该 Headless Service，否则 DNS 不生成 pod-name.service-name 格式的记录。
- Headless Service 的
metadata.name必须和 StatefulSet 的spec.serviceName完全一致（大小写敏感） - Service 的
selector必须精确匹配 StatefulSet 模板里的labels，否则 Endpoint 不生成，DNS 查不到任何地址 - Pod 内的 Go 应用应使用完整域名，例如
redis-1.redis-headless.default.svc.cluster.local:6379，而非简写redis-1:6379（后者依赖 /etc/hosts，不可靠） - 若 Go 程序跑在非 default 命名空间，域名后缀要改成
..svc.cluster.local
容易被忽略的 DNS 解析失败点
Go 客户端查不到 Pod IP，90% 不是代码问题，而是 DNS 层没生效。先确认三件事：
- 执行
kubectl get endpoints redis-headless，输出里要有对应数量的 IPs；为空说明 selector 不匹配或 Pod 未就绪 - 进任一 Pod 执行
nslookup redis-headless.default.svc.cluster.local，看是否返回多个 A 记录；若只返回一个或报 NXDOMAIN，检查 Service 的clusterIP: None是否拼错（比如写成"none"或空字符串） - Go 的
net.LookupHost默认用系统 resolver，Pod 内若启用了ndots:5（默认值），查redis-headless会先尝试补全五次后缀，超时严重；建议始终用 FQDN，或在 Pod 的/etc/resolv.conf中设options ndots:1
真正麻烦的不是写代码，而是让 DNS 把每个 Pod 的名字稳稳地、及时地、准确地告诉 Go 程序——这中间差一个 label、一个字段、一个 dot，都会让连接静默失败。
