如何删除Kafka Topic的retention.ms配置以恢复默认留存时长

操作确认 #

你准备使用的删除Topic层级retention.ms配置的命令完全正确，可以实现恢复默认24小时留存的需求。

原理说明 #

Kafka配置生效优先级为：Topic级别动态配置 > Broker节点server.properties全局配置。
此前你为test Topic手动设置的retention.ms=64000属于Topic级别的覆盖配置，删除该配置后，test Topic会自动继承集群全局定义的默认24小时留存规则，完全符合你的预期。

操作&验证步骤 #

1. 执行删除配置命令：

kafka-configs.sh --zookeeper zoo_server:2181 --alter --entity-type topics --entity-name test --delete-config retention.ms

2. 执行如下命令验证配置是否恢复默认：

kafka-topics.sh --zookeeper zoo_server:2181 --describe --topics-with-overrides

如果输出列表中没有test Topic，说明该Topic已无自定义覆盖配置，成功继承全局默认值。

两种方案对比 #

• 直接设置retention.ms=86400000的方案：test Topic仍保留自定义覆盖配置，后续如果集群全局默认留存时长调整，该Topic不会同步生效，只是当前数值和默认值一致。
• 删除Topic级配置的方案：test Topic完全跟随全局配置变动，是真正意义上的恢复默认值，更推荐使用。

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