Bruno项目OpenAPI导入PUT请求体丢失问题解析

问题背景

在Bruno项目（一款API开发测试工具）中，用户反馈通过OpenAPI YAML文件导入API集合时，PUT请求的请求体内容未被正确导入。进一步测试发现，该问题不仅限于PUT方法，当同一个Schema被多个操作引用时，后续操作的请求体都会丢失。

技术分析

问题复现

通过以下OpenAPI定义可稳定复现问题：

paths:
  /resource:
    put:
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Model"
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Model"
components:
  schemas:
    Model:
      type: object
      properties:
        id: { type: integer }
        name: { type: string }

导入后生成的Bruno集合文件中，只有第一个引用该Schema的操作（无论是PUT还是POST）会包含请求体模板，后续操作则丢失了请求体定义。

根本原因

问题出在OpenAPI导入器的引用解析逻辑中。代码使用了一个共享的visitedItems集合来跟踪已解析的引用路径，当遇到重复引用时直接跳过解析。这种设计导致：

1. 首次解析#/components/schemas/Model时，其路径被标记为已访问
2. 后续操作引用同一Schema时，解析器认为该引用已处理，直接跳过
3. 最终只有第一个操作获得请求体定义

解决方案

修复方案

修改引用解析策略，为每次递归解析创建新的visitedItems集合副本。具体实现要点：

1. 在递归调用resolveRef时，通过new Set(visitedItems)创建新集合
2. 每个解析分支独立维护已访问路径记录
3. 确保相同Schema在不同上下文中都能被正确解析

修复效果

修复后：

• 所有HTTP方法（PUT/POST/PATCH等）都能正确导入请求体
• 同一Schema被多次引用时，每个操作都会获得完整的请求体模板
• 生成的Bruno文件包含预期的JSON结构模板

最佳实践建议

对于OpenAPI规范使用者：

1. 复杂Schema建议定义在components中复用
2. 注意不同HTTP方法可能需要不同的请求体示例
3. 导入后应验证所有操作的完整性

对于API工具开发者：

1. 引用解析需要考虑多上下文场景
2. 递归算法中需注意状态隔离
3. 应针对多引用场景编写专项测试用例

该修复已合并至Bruno主分支，将在v1.35.0版本中发布。