Swagger字段属性说明不显示

如果你在使用Swagger时发现接口文档中字段的属性说明（如字段描述、类型信息等）没有正常显示，这可能是由于以下几个原因导致的：

1. 缺少注解：确保在模型类（实体类）的字段或getter/setter方法上使用了Swagger提供的注解来提供描述信息。例如，使用@ApiModelProperty注解来添加描述和其它元数据：

   @ApiModelProperty(value = "用户ID", example = "12345", required = true)
   private Long userId;
   1
   2

2. 注解信息不完整：即使使用了@ApiModelProperty，如果没有填写value属性（即描述信息），字段说明自然不会显示。确保为重要的字段添加了必要的描述信息。

3. 配置问题：检查Swagger配置是否正确开启了模型属性的展示。在配置类中，确保.select()方法正确选择了模型类所在的包，以及.apis()和.paths()的配置没有排除了相关接口。

4. 版本兼容性：确保使用的Swagger版本与你的Spring Boot或Spring MVC框架版本兼容。有时候，不同版本之间的差异可能导致某些特性表现不一致。

5. Swagger UI问题：有时候问题可能不在后端配置，而是前端Swagger UI的显示问题。尝试清空浏览器缓存，或者检查是否有其他JavaScript错误阻止了Swagger UI的正常加载。

6. JSON序列化问题：如果使用了特定的JSON序列化库（如Jackson或Gson），确保它们的配置没有无意间排除了Swagger需要的元数据。

7. 重启应用：有时候，即使更改了代码或配置，也需要重启应用服务器以使更改生效。

解决此问题的一般步骤是先检查模型类上的注解是否完整且正确，然后检查Swagger的配置，最后考虑是否存在版本兼容性或前端显示问题。如果所有配置看起来都正确，但问题依旧，尝试查看应用启动日志，看看是否有相关警告或错误信息可以帮助诊断问题。