AKHQ 0.25.1版本Topic数据读取性能问题分析与解决方案

问题背景

在AKHQ 0.25.1版本中，用户反馈在浏览Topic数据时遇到了性能问题。主要表现为：

1. 部分Kafka集群返回503/504错误
2. 数据获取时间相比0.25.0版本显著增加
3. 回退到0.25.0版本后问题消失

问题根源分析

经过技术团队调查，发现问题主要源于0.25.1版本中的两个关键配置变更：

1. max.poll.records参数：默认值从50大幅提升至25,000
2. poll-timeout参数：默认值从1,000ms增加到10,000ms

这些变更导致AKHQ客户端在以下场景出现性能问题：

• 当Topic中的数据量不足25,000条时，客户端会等待10秒直到超时
• 对于某些Kafka集群配置，大容量数据拉取可能导致请求超时（504错误）

解决方案

针对这一问题，建议采用以下配置优化：

akhq:
  clients-defaults:
    consumer:
      properties:
        max.poll.records: 50  # 恢复0.25.0版本的默认值
  topic-data:
    poll-timeout: 1000  # 恢复0.25.0版本的默认超时时间

性能对比

测试表明，使用优化配置后：

• 数据获取成功率恢复
• 响应时间较0.25.1默认配置提升3-4倍
• 但仍略慢于0.25.0版本，这可能是由于其他底层优化带来的轻微性能影响

最佳实践建议

1. 对于生产环境，建议在升级前测试新配置
2. 根据实际Topic数据量和集群性能调整这两个参数
3. 监控请求日志中的Duration字段，如：[Duration: 1824 ms] [Url: GET /api/cluster/topic/your_topic/data]
4. 对于大数据量Topic，可以适当增加max.poll.records值，但需平衡响应时间

总结

AKHQ 0.25.1版本的这一变更展示了配置优化对系统性能的重要影响。开发者在升级时应当注意版本变更日志中的配置调整，并根据实际环境进行适当调优，以在功能性和性能之间取得最佳平衡。