如何将Web服务器接入Kubernetes StatefulSet与Headless服务实现Postgres读写分离

核心实现逻辑 #

你需要拆分2个独立的Service做流量定向分发，不需要修改StatefulSet本身的配置：

• 写请求专用Service：配置标签选择器仅匹配主节点Pod，比如你的主节点Pod打了role: postgres-master标签，就将spec.selector设置为该键值对，类型用默认ClusterIP即可。所有写请求只会被转发到主节点，完全不会走到从节点。
• 读请求专用Service：配置标签选择器仅匹配所有从节点Pod，比如选择role: postgres-slave标签，同样用ClusterIP类型，自带4层负载均衡能力，会自动将读请求分摊到所有健康的从节点，实现资源利用率最大化。

如果你的PostgreSQL集群是用开源Operator（如Zalando Postgres Operator、Crunchy Postgres for Kubernetes）部署的，主从Pod的角色标签默认已经配置完成，直接引用即可。如果是手动封装的StatefulSet，需要配套编写简单的sidecar或者控制器，在主从切换时自动更新Pod的角色标签，保证流量路由的准确性。

双端点配置说明 #

是需要在Web服务中配置两个独立的数据库端点的，你可以根据技术栈选择两种实现方式：

• 框架层自动路由：如果你的后端框架支持读写分离插件（比如Java生态的MyBatis-Plus、Python生态的SQLAlchemy读写分离中间件、Go生态的GORM读写分离插件），只需要在配置文件中分别填写写Service、读Service的DNS地址，框架会自动将SELECT请求路由到读端点，INSERT/UPDATE/DELETE等写请求路由到写端点，不需要修改业务代码。
• 业务层手动路由：如果框架没有对应的插件，就需要在业务代码中对读写操作做拆分，分别调用两个数据源。

常见使用误区说明 #

你目前对Headless Service的使用确实存在理解偏差：

• Headless Service的核心作用是为StatefulSet的每个Pod生成固定格式的独立DNS条目（格式为[Pod名称].[Headless Service名称].[命名空间].svc.cluster.local），主要用于StatefulSet集群内部的节点通信（比如PostgreSQL主从数据同步、分布式集群的选主逻辑），不适合作为业务侧的统一访问入口。
• 不要直接在Web服务中硬编码单个Pod的IP或者Pod级别的DNS地址，StatefulSet的Pod重建后IP会发生变化，只有Service的DNS是长期稳定的，哪怕后端Pod漂移也不会影响业务可用性。
• 不要用单个ClusterIP Service挂载所有主从Pod，这种配置下写请求有概率被负载均衡到从节点，直接导致写操作失败。

内容的提问来源于stack exchange，提问作者joe1531