spring Boot 集成 Swagger 时，Controller 方法缺少 @RequestMapping 注解导致 Swagger ui 无法正确显示 API 接口，这是一个常见问题。
问题：开发者在 spring boot 项目中，某个 Controller 方法未添加 @RequestMapping 注解，导致 Swagger UI 报错。 开发者原本认为接口路径无需修改，但 Swagger 报错后才意识到问题。通过在方法上添加多级路径，解决了该问题，推测 Swagger 无法根据请求方式解析接口。
原因分析：@RequestMapping 注解是 Spring mvc 的核心注解，用于将 http 请求映射到 Controller 方法。 缺少该注解，spring mvc 无法确定哪个 URL 对应哪个方法，自然 Swagger UI 也无法正确解析和显示 API。
疑问：如果不用 @RequestMapping，为何使用 Controller 进行地址映射？Controller 的核心功能是处理 HTTP 请求，@RequestMapping 正是建立 Controller 与 HTTP 请求映射的关键。 没有 @RequestMapping，Controller 就无法接收任何请求，形同虚设。
解决方案：在需要 Swagger UI 显示的 Controller 方法上添加 @RequestMapping 注解，明确指定 URL 路径。 开发者通过添加多级路径，实际上实现了 @RequestMapping 的功能，从而解决了 Swagger 报错。 这再次强调了 @RequestMapping 注解在 Spring MVC 和 Swagger UI 中的重要性。
