Swagger部分接口示例Schema不显示仅展示默认"string"问题求助

• 检查序列化器定义一致性
  确认api/user/verify之后的接口所用序列化器，是否存在这些问题：

  • 字段未显式指定类型，或使用SerializerMethodField时未配置output_field
  • 序列化器继承关系异常，子类未正确继承父类的字段配置
  • 字段设了allow_null=True但未配合正确类型声明，导致Swagger无法推断真实类型

• 排查路由分组与Schema生成逻辑
  检查项目路由配置：

  • api/user/verify之后的路由是否用了特殊分组（比如include的子路由未正确注册到Swagger生成器）
  • 是否对这些接口设置了自定义Schema排除规则，或使用@swagger_auto_schema/@extend_schema装饰器时遗漏了Schema配置

• 验证模型字段与序列化器的映射
  如果接口关联Django模型：

  • 确认模型字段是否未正确映射（比如模型用TextField但序列化器未指定style或example）
  • 检查模型字段用了choices但序列化器未配置choices参数，导致Swagger无法识别枚举类型

• 检查库版本与兼容性

  • 确认drf-yasg/drf-spectacular与Django REST Framework的版本匹配（比如DRF 3.14+对应最新版spectacular）
  • 尝试更新Swagger库到最新版本，修复已知的Schema生成bug

• 调试Schema生成过程

  • 用drf-spectacular的manage.py spectacular --file schema.yml生成完整OpenAPI Schema文件，查看异常接口的Schema定义，定位是字段缺失还是类型推断错误
  • 对单个异常接口，临时简化序列化器（只留核心字段），测试能否正常生成Schema，逐步排查问题字段

内容的提问来源于stack exchange，提问作者Davidson Co