使用Swagger时输入字段属性名重复问题求助

以下是几个常见的排查方向和解决方法：

• 检查OpenAPI/Swagger Schema定义
  • 确认目标Schema的properties节点中，numeroMatricula是否被重复声明；同时排查是否通过allOf/anyOf组合了多个包含该字段的Schema，导致合并后重复。
• 排查代码自动生成的注解冲突
  • 若使用SpringDoc、Springfox等框架自动生成文档，检查实体类中numeroMatricula字段是否存在重复注解（比如同时使用@JsonProperty和@ApiModelProperty且配置重复），或者字段本身在类中有重复定义（如私有字段+重复的getter注解）。
• 升级Swagger UI版本
  • 部分旧版Swagger UI存在渲染Bug，会导致字段重复显示，尝试升级到最新稳定版（如3.x系列）后再验证。
• 调整Schema的additionalProperties配置
  • 如果Schema设置了additionalProperties: true，同时又显式定义了numeroMatricula，可能触发渲染重复，可将additionalProperties设为false或明确限定允许的额外属性范围。
• 清理缓存
  • 浏览器缓存或Swagger UI的本地缓存可能保留了旧的Schema数据，强制刷新页面（Ctrl+F5）或清除浏览器缓存后重试。

内容的提问来源于stack exchange，提问作者Mario Cañas