drf-spectacular问题：超60个接口后示例值显示'string'

可能的原因 #

• Swagger UI渲染阈值限制：部分旧版本Swagger UI为了提升性能，当接口数量达到特定阈值（比如60个）时，会自动简化部分字段的示例展示，用基础类型占位符string替代自定义示例。
• 文档生成工具的批量处理逻辑：如果使用Springfox、Swagger Codegen这类工具生成OpenAPI文档，可能存在批量处理时的缓存或截断机制，超过数量阈值后默认跳过自定义示例的生成。
• 前端性能优化触发：浏览器渲染大量接口时，Swagger UI可能触发内存优化策略，跳过复杂示例的渲染流程，直接显示默认占位符。

排查与解决步骤 #

1. 升级Swagger UI版本
   确认当前使用的Swagger UI版本，优先升级到最新稳定版，新版本通常修复了这类数量阈值导致的渲染异常问题。
2. 调整文档生成配置
   • 若用Springfox等后端工具，检查是否存在示例展示相关的优化配置，尝试关闭批量生成时的简化逻辑。
   • 手动检查OpenAPI YAML/JSON文件，确保有问题的接口Schema中example字段定义正确，避免因Schema不规范导致渲染失败。
3. 禁用Swagger UI性能优化
   在Swagger UI初始化配置中，调整或关闭性能优化参数，比如maxDisplayedTags、supportedSubmitMethods等，强制渲染所有接口的完整示例。
4. 拆分API文档
   将API按业务模块拆分，通过标签（Tags）分组或设置独立文档入口，避免单文档内接口数量过多触发限制。
5. 显式强制指定示例值
   对关键接口的Schema字段，手动添加example字段强制指定示例内容，确保优先显示自定义示例而非默认占位符。示例：

   components:
     schemas:
       Order:
         type: object
         properties:
           orderId:
             type: string
             example: "ORD20240501001"
   

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