RequiresPermissions注解导致swagger失效

`RequiresPermissions` 注解通常用于Spring Security框架中，它用于限制只有具备特定权限的用户才能访问某个REST API。当这个注解应用到控制器方法上时， Swagger（一个流行的API文档生成工具）可能会出现问题，因为Swagger并不直接解析Spring Security的注解来生成API文档。

Swagger需要的是明确的HTTP请求映射和返回值类型等信息来构建API文档，而`@RequiresPermissions`这类基于角色或权限的控制，其逻辑是在服务器运行时检查，而不是通过直接暴露给Swagger的数据来确定。

为了解决这个问题，你可以采取以下步骤让Swagger能正确地显示带有`@RequiresPermissions`的API：

1. **忽略该注解**：在Swagger配置文件（通常是application.yml或application.properties）中，可以设置`springdoc.swagger.web.path-mapping.include-controller-regex`或类似属性，将包含`@RequiresPermissions`注解的控制器路径排除在外。

2. **使用自定义拦截器**：创建一个Swagger的拦截器或者处理器，在生成API文档之前先检查权限，如果权限不足则跳过该接口的文档生成。

3. **使用第三方插件**：有些第三方库如`springfox-swagger2-permissions-plugin`可以帮助整合Swagger和Spring Security，提供更精确的权限支持，同时允许在文档中显式标识需要权限的API。