swagger3 @Schema注解失效

Swagger 3 是一款流行的 API 设计和文档生成工具，`@Schema` 注解用于指定 JSON 数据模型中的元数据信息，如字段名称、描述、类型等。如果你遇到 `@Schema` 注解失效的情况，可能是以下几个原因：

1. **版本兼容性问题**：确认你在使用的 Swagger 版本中是否支持该注解。早期版本可能对某些功能进行了调整或移除。确保你的项目配置了正确的 Swagger 客户端库（如 swagger-ui 或 springfox）及其对应的 Swagger 3.x 配置。

2. **注解位置错误**：`@Schema` 必须放在 Java 类的字段上，方法参数或返回值前。如果它位于类或方法级别，可能不会被正确解析。

3. **全局配置**：有些时候，Swagger 可能需要在全局配置文件中启用 `@Schema` 插件或者设置默认的行为才能识别这些注解。检查你的 Swagger 配置是否有相关的启用设置。

4. **IDE/构建工具插件问题**：有时 IDE 或构建工具插件可能没有正确地处理 Swagger 注解。尝试清理并重新构建项目，或者更新相应的插件到最新版本。

5. **冲突的依赖**：如果有多个第三方库使用了相似的功能，可能会导致冲突。确保你的项目中只有一个 Swagger 相关的库，并且没有其他库无意中覆盖了 `@Schema` 功能。