Docker Compose启动Kafka报错：No security protocol defined for listener

AI 小北

2026-6-16

问题

使用docker-compose start启动Kafka时出现报错：No security protocol defined for listener。

以下是docker-compose.yaml配置文件内容：

version: '3'
services:
  zookeeper:
    image: confluentinc/cp-zookeeper:latest
    environment:
      ZOOKEEPER_CLIENT_PORT: 2181
 
    ports:
      - 2181:2181
    volumes:
      - ./data/zookeeper_data:/var/lib/zookeeper/data
      - ./data/zookeeper_log:/var/lib/zookeeper/log      

  kafka:
    image: confluentinc/cp-kafka:latest
    depends_on:
      - zookeeper
    ports:
      - 9092:9092
      - 9094:9094
    volumes:
      - ./data/kafka1/data:/var/lib/kafka/data
      - ./data/kafka1/etc:/etc/kafka
    environment:
      ALLOW_PLAINTEXT_LISTENER: yes
      KAFKA_ENABLE_KRAFT: no
      KAFKA_BROKER_ID: 1
      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
      KAFKA_INTER_BROKER_LISTENER_NAME: INTERNAL
      KAFKA_LISTENERS: INTERNAL://:9092,OUTSIDE://:9094
      KAFKA_ADVERTISED_LISTENERS: INTERNAL://kafka:9092,OUTSIDE://localhost:9094
      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: INTERNAL:PLAINTEXT,OUTSIDE:PLAINTEXT

删除data目录下所有卷文件夹后，Kafka可正常启动，请问该问题的原因是什么？

原因分析

旧集群元数据与新配置冲突：Kafka会把监听器、安全协议映射等核心配置持久化到ZooKeeper和本地数据卷中。如果之前启动时用过不同的监听器配置（比如未区分INTERNAL/OUTSIDE、安全协议映射不一致），这些旧元数据会被保留。修改配置后重启，Kafka加载旧元数据时，会发现新配置的监听器和旧数据里的安全协议不匹配，从而抛出"No security protocol defined for listener"错误。
本地挂载目录残留旧配置：你挂载了./data/kafka1/etc:/etc/kafka目录，该目录可能留存了之前生成的server.properties文件，里面的监听器配置和当前docker-compose.yaml中的环境变量配置不一致，启动时加载旧配置就会引发协议定义缺失的问题。
ZooKeeper旧数据未清理：ZooKeeper的data卷存储了Kafka集群的注册信息，包括旧的监听器配置。即使修改了Kafka的环境变量，ZooKeeper里的旧数据依然存在，Kafka启动时读取这些旧数据后，会和新配置产生冲突，导致报错。删除所有卷文件夹后，ZooKeeper和Kafka的旧数据被清空，会重新根据新配置初始化，因此能正常启动。

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