使用Docker Compose host网络部署Redis集群后容器内服务无法连接

报错根因 #

1. host网络模式下Docker服务名解析失效：所有Redis相关服务都配置了network_mode: "host"，这种模式下容器直接共享宿主机的网络命名空间，Docker内置的服务名DNS解析、links配置仅在bridge网络模式下生效，user_service容器内无法将redis-cluster解析为正确的IP地址，因此抛出UnknownHostException。
2. Redis集群拓扑地址匹配异常：使用服务名redis-cluster作为初始连接地址时，Redis集群返回给客户端的节点拓扑地址和客户端用的服务名不匹配，也会触发拓扑刷新失败的报错。
3. 本地运行服务能连接成功，是因为本地的localhost直接指向宿主机，而Redis节点在host模式下端口直接绑定在宿主机网卡上，所以可以直接通过localhost:端口访问。

解决方案 #

方案1（最稳妥）：user_service同步使用host网络模式 #

将user_service也配置为network_mode: "host"，同时删除无效的links配置，修改后的Docker Compose对应部分如下：

user_service:
  depends_on:
    - "redis-cluster"
  network_mode: "host"
  build:
    context: .
    dockerfile: DockerFile_Builders/Services/User/Dockerfile

Java连接代码和本地运行时保持一致即可：

RedisURI masterURI = RedisURI.create("redis://localhost:7001");

方案2：使用宿主机物理IP连接 #

如果user_service不能使用host网络模式，直接把连接地址替换为宿主机的物理IP即可：

RedisURI masterURI = RedisURI.create("redis://[宿主机局域网IP]:7001");

只要宿主机和user_service容器网络互通，即可正常连接Redis集群。

额外优化建议 #

在Redis节点的配置文件中显式指定cluster-announce-ip为宿主机的物理IP，避免多网卡场景下Redis自动识别IP出错，导致客户端拓扑刷新异常。

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