M1芯片MacOS Monterey环境下Demo-Kafka启动失败（退出码1）

核心问题分析 #

1. 架构兼容性问题：wurstmeister/kafka的旧版本镜像（如2.12-2.4.1）未适配Apple Silicon（ARM64）架构，运行时可能出现底层兼容性错误，导致ZooKeeper连接失败。
2. 容器启动顺序问题：depends_on仅保证ZooKeeper容器启动，但不等待其服务完全就绪，Kafka启动时ZooKeeper可能还未完成初始化，导致连接超时。
3. 配置冗余与适配问题：部分配置项重复（如KAFKA_PORT和KAFKA_LISTENERS冲突），且未针对Docker环境做必要的网络适配。

修正后的docker-compose配置 #

替换为适配ARM架构的镜像，并优化启动逻辑和配置：

version: '3.7'
services:
  zookeeper:
    container_name: demo-zookeeper
    image: bitnami/zookeeper:3.8.0
    ports:
      - "2181:2181"
    environment:
      ALLOW_ANONYMOUS_LOGIN: 'yes'
    healthcheck:
      test: ["CMD", "zkServer.sh", "status"]
      interval: 10s
      timeout: 5s
      retries: 5

  kafka:
    container_name: demo-kafka
    image: bitnami/kafka:2.8.2
    depends_on:
      zookeeper:
        condition: service_healthy
    ports:
      - "9092:9092"
      - "9093:9093"
    environment:
      KAFKA_BROKER_ID: 1
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
      KAFKA_LISTENERS: PLAINTEXT://:9092,PLAINTEXT_HOST://:9093
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://demo-kafka:9092,PLAINTEXT_HOST://localhost:9093
      ALLOW_PLAINTEXT_LISTENER: 'yes'

关键调整说明 #

• 镜像替换：使用Bitnami官方的ZooKeeper和Kafka镜像，均原生支持ARM64架构，避免兼容性问题。
• 健康检查：给ZooKeeper添加healthcheck，确保Kafka仅在ZooKeeper服务完全就绪后启动，解决连接超时问题。
• 监听器配置：区分容器内部通信（PLAINTEXT）和本地主机访问（PLAINTEXT_HOST），避免网络访问冲突。
• 冗余配置移除：删除重复的KAFKA_PORT、KAFKA_ADVERTISED_PORT等配置，使用KAFKA_LISTENERS统一管理。

额外启动注意事项 #

1. 执行启动命令前，清理旧容器和缓存：

docker-compose down -v
docker system prune -f

2. 启动后验证服务状态：

# 检查ZooKeeper状态
docker exec demo-zookeeper zkServer.sh status
# 创建测试主题并验证
docker exec demo-kafka kafka-topics.sh --create --topic test-topic --bootstrap-server localhost:9092 --partitions 1 --replication-factor 1

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