Kafka主题存储路径由Broker全局配置log.dirs决定，主题级参数仅控制日志分段与保留策略；需手动设置log.dirs并确保路径可读写，Topic级通过log.segment.bytes、retention.ms等参数覆盖默认值，日志结构自动生成且不可更改。
Kafka 主题本身不直接配置存储目录，它的底层存储路径由 Broker 全局控制，而日志格式（如分段大小、索引类型、清理策略等）则通过 Broker 配置 + Topic 级参数协同决定。实际操作中，你只需配置 Broker 的日志根目录和关键行为参数，Kafka 会自动按规则组织主题分区的文件结构。
Broker 级：指定日志根目录
所有主题的分区数据都落在 log.dirs 指定的路径下。这是唯一需要手动设置的“存储目录”位置。
- 编辑
config/server.properties - 设置
log.dirs=/your/path/to/kafka-logs（Linux）或log.dirs=e:\kafka\data\kafka\kafka-logs（Windows，注意双反斜杠） - 确保该路径存在、可读写，且磁盘空间充足
- 一个 Broker 可配置多个路径（用逗号分隔），Kafka 会轮询使用以均衡 IO
Topic 级：控制日志分段与保留行为
每个主题可单独设定日志切分粒度和生命周期，覆盖 Broker 默认值。
-
log.segment.bytes（默认 1GB）：单个 .log 文件最大字节数。设为
1048576（1MB）便于测试观察分段效果 -
retention.ms 或 retention.hours：消息保留时长。例如创建 topic 时指定：
bin/kafka-topics.sh --create --topic my-topic --partitions 3 --replication-factor 1 --config retention.ms=86400000（保留 1 天） - retention.bytes：按磁盘空间限制保留（较少用，需谨慎设置避免意外截断）
日志文件结构：无需配置，自动生成
Kafka 固定采用 Segment + Index 结构，你不能更改格式，但能影响其表现：
- 每个分区（如
my-topic-0）是一个子目录 - 目录内含多个
00000000000000000000.log（数据）、.index（偏移索引）、.timeindex（时间戳索引）文件 - 新消息追加到当前活跃 segment；达到
log.segment.bytes后滚动新建 segment -
leader-epoch-checkpoint和__cluster_metadata-0等元数据文件由 Kafka 自动维护
启动前必须完成的初始化步骤
尤其在 Kafka 4.0+（KRaft 模式）下，跳过会导致启动失败：
- 生成集群 ID：
bin/kafka-storage.sh random-uuid - 更新
server.properties中的cluster.id和controller.quorum.voters - 执行格式化：
bin/kafka-storage.sh format -t-c config/server.properties
