在统信UOS系统上部署Kafka必须先解决Java环境缺失、ZooKeeper未启用、路径权限不足三大障碍；需安装OpenJDK 11并正确配置JAVA_HOME（arm64平台须用aarch64路径），下载kafka_2.13-3.6.0二进制包解压至/opt/kafka，显式设置zookeeper.dataDir=/var/lib/zookeeper及kafka的listeners、advertised.listeners和log.dirs，最后以-daemon方式先启ZooKeeper再启Kafka。
在统信UOS系统上部署Kafka消息队列，必须先解决Java环境缺失、ZooKeeper服务未启用、配置路径权限不足三大核心障碍，否则启动时会直接报错ClassNotFoundException或zookeeper not bound。
安装OpenJDK 11并配置JAVA_HOME
统信UOS默认不预装JDK，而Kafka 3.6.0+强制要求JDK 11运行环境，低于该版本将触发UnsupportedClassVersionError错误。
执行java -version检查当前Java状态，若提示“command not found”或输出版本号小于11，则必须安装。
运行sudo apt update && sudo apt install openjdk-11-jdk安装官方源提供的兼容包。
验证安装结果：输出中必须包含openjdk version "11.字样，否则说明安装失败或版本不对。
设置全局JAVA_HOME：echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' | sudo tee -a /etc/profile && source /etc/profile。注意路径中的amd64仅适用于x86_64架构；若为arm64设备（如飞腾/鲲鹏平台），需替换为aarch64，否则Kafka脚本无法识别JVM。
下载解压Kafka二进制包
使用Kafka官方推荐的Linux通用tar.gz包，避免选用未经UOS适配的高版本（如4.x），防止因glibc线程模型差异导致kafka-server-start.sh启动后立即退出。
创建标准部署目录：sudo mkdir -p /opt/kafka && sudo chown $USER:$USER /opt/kafka。
从阿里云镜像站下载经UOS验证的稳定版本：wget https://mirrors.aliyun.com/apache/kafka/3.6.0/kafka_2.13-3.6.0.tgz。
解压至目标目录并剥离顶层文件夹：tar -xzf kafka_2.13-3.6.0.tgz -C /opt/kafka --strip-components=1。
进入/opt/kafka目录，确认bin/、config/、libs/三个子目录存在且非空——缺少任一目录说明解压失败或包损坏。
启用内置ZooKeeper并配置数据路径
Kafka 3.6.0默认启用内置ZooKeeper，但UOS系统中若不显式配置dataDir，服务将默认写入/tmp，而UOS的systemd-tmpfiles定期清理/tmp会导致元数据丢失、集群不可用。
编辑ZooKeeper配置：nano /opt/kafka/config/zookeeper.properties。
找到dataDir行，将其修改为dataDir=/var/lib/zookeeper；该路径必须提前创建且赋予写权限：sudo mkdir -p /var/lib/zookeeper && sudo chown $USER:$USER /var/lib/zookeeper。
同时确认clientPort=2181未被注释，且端口未被其他进程占用（可用ss -tuln | grep :2181检查）。
【关键前提】必须确保/var/lib/zookeeper目录存在且当前用户有读写权限，否则ZooKeeper启动时静默失败，后续Kafka连接拒绝。
配置Kafka监听地址与日志路径
统信UOS环境下，Kafka默认配置的listeners=PLAINTEXT://:9092无法被外部访问，因为advertised.listeners未显式设置，会导致生产者/消费者连接超时或解析到localhost。
编辑/opt/kafka/config/server.properties：
① 设置唯一broker标识：broker.id=0（单机部署固定为0）；
② 显式定义监听地址：listeners=PLAINTEXT://0.0.0.0:9092；
③ 必须同步配置对外广播地址：advertised.listeners=PLAINTEXT://$(hostname -I | awk '{print $1}'):9092——此处用命令替换获取本机实际IP，避免填localhost或127.0.0.1；
④ 修改日志存储路径：log.dirs=/var/lib/kafka-logs，然后执行sudo mkdir -p /var/lib/kafka-logs && sudo chown $USER:$USER /var/lib/kafka-logs；
⑤ 禁用ZooKeeper外连（启用内置）：zookeeper.connect=localhost:2181保持默认即可，无需改成本地IP。
以daemon方式启动ZooKeeper和Kafka
必须严格按顺序启动：先ZooKeeper再Kafka，否则Kafka初始化时无法注册节点，报错“Connection refused”。
方法一：后台启动ZooKeeper服务：/opt/kafka/bin/zookeeper-server-start.sh -daemon /opt/kafka/config/zookeeper.properties。
方法二：后台启动Kafka服务：/opt/kafka/bin/kafka-server-start.sh -daemon /opt/kafka/config/server.properties。
验证ZooKeeper是否就绪：echo stat | nc localhost 2181 | grep Mode，输出含Mode: standalone即成功。
验证Kafka是否运行：jps | grep Kafka，看到Kafka进程名即表示服务已拉起。
