RapiDoc项目中show-curl-before-try参数导致无限循环问题的技术分析

在RapiDoc项目使用过程中，开发者反馈当结合大型OpenAPI规范文件使用show-curl-before-try参数时，会出现界面渲染卡死的现象。经过技术分析，该问题与特定数据格式处理逻辑相关，以下是深度技术解析。

问题现象

当配置show-curl-before-try=true时，若OpenAPI规范中存在以下特征：

1. 包含复杂数据结构的大型规范文件
2. 定义有format: uuid的字符串类型字段 界面渲染进程会进入无限循环状态，导致浏览器标签页无响应。

根本原因

通过技术排查发现，问题核心在于：

1. CURL生成逻辑：该参数会为每个API端点预生成CURL命令模板
2. UUID格式处理：当遇到type:string + format:uuid的组合时，参数序列化过程存在递归处理缺陷
3. 性能瓶颈：大型规范文件会放大该缺陷的影响，形成计算密集型阻塞

解决方案

临时解决方案

1. 禁用问题参数：show-curl-before-try=false
2. 修改规范文件：移除format: uuid的类型定义

推荐方案

1. 使用render-style="focused"模式：该模式仅渲染当前聚焦的API路径，显著降低计算负载
2. 分模块加载：将大型规范拆分为多个逻辑模块分别加载

技术建议

对于移动端适配需求，建议采用以下组合配置：

<rapi-doc
  render-style="focused"
  mobile-breakpoint="768"
  show-curl-before-try="false"
/>

后续优化

该问题已提交至项目维护团队，预计将在后续版本中通过以下方式修复：

1. 增加CURL生成过程的递归深度检测
2. 对UUID等特殊格式添加缓存处理机制
3. 实现大型规范文件的渐进式渲染策略

开发者在使用时应注意规范文件的复杂度控制，对于包含超过50个API端点或复杂Schema定义的规范，建议优先采用分模块加载策略。