EventCatalog OpenAPI 标签分组显示问题解析

EventCatalog 是一个用于管理事件驱动架构的文档工具，它支持通过 OpenAPI 规范展示 API 文档。近期用户反馈在使用 2.7.16 版本时遇到了 OpenAPI 路径标签分组名称不显示的问题。

问题现象

在 OpenAPI 规范文件中，开发者会为 API 路径添加标签(tags)以便分类管理。例如：

/getPricingFunctions:
  get:
    operationId: GetPricingFunctionsUsecase
    tags:
      - Pricing Functions
    summary: Get all pricing functions filtered by state

按照预期，EventCatalog 应该在左侧导航栏中显示这些标签作为分组标题（如"Pricing Functions"），并将相关 API 路径组织在这些分组下。然而实际呈现时，分组标题区域却显示为空白，只有路径摘要可见。

技术分析

这个问题属于界面渲染逻辑的缺陷。EventCatalog 在解析 OpenAPI 规范时能够正确识别标签并创建分组结构，但在渲染阶段未能将标签文本输出到界面上。这可能是由于：

1. 标签数据在组件间传递时丢失
2. 渲染模板中缺少对标签文本的输出
3. CSS 样式问题导致文本不可见

解决方案

项目维护团队在 2.8.1 版本中修复了这个问题。新版本不仅正确显示了标签名称，还改进了用户体验：

1. 分组标题现在清晰可见
2. 添加了可折叠功能（默认展开）
3. 优化了整体导航结构

升级建议

遇到此问题的用户应升级到最新版本。升级后，原有的 OpenAPI 规范无需修改即可正常显示标签分组。如果升级后仍遇到界面卡顿问题，建议检查 OpenAPI 文件是否过大或包含特殊结构。

EventCatalog 作为一个活跃的开源项目，持续改进其 OpenAPI 支持能力，为开发者提供更好的 API 文档管理体验。