IntelliJ本地运行Spring Boot应用无法连接Docker部署Kafka问题咨询

首先明确问题根源：

• docker内部的服务域名kafka仅能在mynetwork网络下解析，IntelliJ启动的宿主机进程不在该网络内，无法解析该域名
• 你现有的Kafka监听器配置存在参数错配，导致对外暴露的29092端口未正常工作

第一步：修正docker-compose的Kafka配置 #

调整kafka服务的environment参数如下：

environment:
  - ZOOKEEPER_CONNECT=zookeeper:2181
  - KAFKA_LISTENER_SECURITY_PROTOCOL_MAP=INTERNAL:PLAINTEXT,EXTERNAL_SAME_HOST:PLAINTEXT
  - KAFKA_ADVERTISED_LISTENERS=INTERNAL://kafka:9092,EXTERNAL_SAME_HOST://localhost:29092
  - KAFKA_LISTENERS=EXTERNAL_SAME_HOST://0.0.0.0:29092,INTERNAL://0.0.0.0:9092
  - KAFKA_INTER_BROKER_LISTENER_NAME=INTERNAL

修改点说明：

1. 删除了无用的PLAINTEXT协议映射，避免冲突
2. 将KAFKA_INTER_BROKER_LISTENER_NAME从错误的PLAINTEXT改为实际存在的内部监听器名称INTERNAL
3. 监听地址改为0.0.0.0确保Kafka在容器内监听所有网卡，避免端口绑定问题

第二步：重启docker服务 #

执行以下命令重启所有服务，确保配置生效：

docker-compose down -v
docker-compose up -d

注意加-v会删除临时卷，Kafka原有数据会清空，如果需要保留数据可以去掉该参数。

第三步：验证宿主机连通性 #

先验证29092端口在宿主机是否可访问：

telnet localhost 29092
# 或者用nc命令
nc -zv localhost 29092

如果连通正常，再修改IntelliJ中Spring Boot的配置文件：

spring.kafka.bootstrap-servers=localhost:29092

重启应用即可正常连接Kafka。

额外排查点 #

如果仍无法连接，检查以下两项：

• 确认你已经提前创建了配置中指定的外部网络mynetwork，如果未创建执行docker network create mynetwork再启动服务
• 确认本地防火墙未拦截29092端口的访问请求

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