Podman部署Kafka集群：Kafka UI无法连接Broker问题排查

核心矛盾出在Kafka的**advertised.listeners**配置逻辑上：

• 当你把KAFKA_CFG_ADVERTISED_LISTENERS设为PLAINTEXT://localhost:9092时，Kafka会给所有客户端返回这个连接地址。Mac本地的Java应用能通过端口映射访问，但容器内的Kafka UI会把localhost解析成自己容器的127.0.0.1，自然连不上Kafka容器。
• 改成PLAINTEXT://kafka-server:9092后，容器内的Kafka UI能通过容器名直接找到Kafka，但Mac本地的Java应用无法识别容器网络内的kafka-server主机名，导致连接失败。

让Kafka同时监听两个地址，分别服务容器内部和外部主机。修改Kafka的启动命令如下：

podman run --name kafka-server --network kafka-network \
  -e ALLOW_PLAINTEXT_LISTENER=yes \
  -e KAFKA_CFG_ZOOKEEPER_CONNECT=zookeeper-server:2181 \
  -e KAFKA_CFG_LISTENERS=PLAINTEXT://0.0.0.0:9092,PLAINTEXT_HOST://0.0.0.0:9093 \
  -e KAFKA_CFG_ADVERTISED_LISTENERS=PLAINTEXT://kafka-server:9092,PLAINTEXT_HOST://localhost:9093 \
  -e KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP=PLAINTEXT:PLAINTEXT,PLAINTEXT_HOST:PLAINTEXT \
  -e KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR=1 \
  -p 9093:9093 \
  docker.io/bitnami/kafka:3.4

对应客户端调整：

• Kafka UI：保持KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka-server:9092不变，用容器内部监听器
• Java应用：改用PLAINTEXT://localhost:9093连接，通过主机映射的端口访问

• KAFKA_CFG_LISTENERS：定义Kafka实际监听的接口和端口，0.0.0.0表示监听所有可用网络。这里配置两个监听器：
  • PLAINTEXT://0.0.0.0:9092：供容器网络内的服务（Kafka UI、Zookeeper）连接
  • PLAINTEXT_HOST://0.0.0.0:9093：供外部主机（Mac本地Java应用）连接
• KAFKA_CFG_ADVERTISED_LISTENERS：Kafka返回给客户端的连接地址，必须和listeners一一对应，分别提供容器内部可解析的主机名和外部可访问的地址
• KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP：映射监听器名称与安全协议，这里两个都用明文协议
• ALLOW_PLAINTEXT_LISTENER：允许使用明文监听器，适合本地测试场景
• KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR：偏移量主题的副本数，单节点集群必须设为1，否则Kafka无法初始化启动

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