swagger3对于Java后端在Controller是添加了@Api注解为什么swaggerUI的界面不显示Controller

在使用Swagger3时，如果Java后端在Controller中添加了@Api注解，但SwaggerUI界面没有显示Controller，可能是由于以下几个原因：

1. 没有启用SwaggerUI的扫描

在启用SwaggerUI时，需要在Spring Boot的启动类上添加@EnableSwagger2或@EnableSwagger2WebMvc注解。如果没有启用SwaggerUI的扫描，即使在Controller中添加了@Api注解，SwaggerUI也无法显示Controller。

2. 没有在Controller上添加@Api注解的具体属性

在@Api注解中有很多属性，例如value、tags、description等，这些属性可以用来描述Controller的信息。如果在Controller上添加了@Api注解，但没有添加具体的属性，SwaggerUI可能无法显示Controller。

3. 没有在Swagger配置文件中配置扫描包路径

在Swagger配置文件中需要添加扫描包路径，才能让SwaggerUI扫描到Controller的信息。如果没有配置扫描包路径，即使在Controller中添加了@Api注解，SwaggerUI也无法显示Controller。

综上所述，如果在Controller中添加了@Api注解，但SwaggerUI界面不显示Controller，需要检查以上三个方面是否都正确配置。

相关问题

SpringBoot使用Swagger2版本和@RequestParam注解在Controller中编写的每个接口的参数添加中文备注

在SpringBoot中使用Swagger2版本和@RequestParam注解可以很方便地为Controller中编写的每个接口的参数添加中文备注，具体步骤如下：

1. 在Controller方法的参数前使用@RequestParam注解，通过value属性设置参数的描述信息。

   @RestController
   @Api(tags = "用户管理接口")
   public class UserController {

       @ApiOperation(value = "获取用户列表", notes = "获取所有用户的列表信息")
       @RequestMapping(value = "/users", method = RequestMethod.GET)
       public List<User> getUsers(@ApiParam(value = "页码", required = false) @RequestParam(value = "pageNum", required = false, defaultValue = "1") int pageNum,
                                   @ApiParam(value = "每页大小", required = false) @RequestParam(value = "pageSize", required = false, defaultValue = "10") int pageSize) {
           // 代码逻辑
       }

   }

2. 在参数上方添加@ApiParam注解，通过value属性设置参数的中文描述信息。

注意事项：使用Swagger2编写API接口参数中文备注时，需要注意参数名称、是否必填、数据类型等信息的准确性，以便生成准确的API文档。

swagger后端 No mapping for GET /api/doc.html

这个问题通常是由于缺少请求映射导致的。当你访问 `/api/doc.html` 路径时，后端应该有一个对应的请求映射来处理这个请求。

首先，你可以检查一下你的后端代码中是否已经有了对应的请求映射。在你的后端框架（比如Spring MVC、Express等）中，你需要定义一个路由来处理 `/api/doc.html` 的 GET 请求。

例如，在Spring MVC中，你可以使用 `@RequestMapping` 或者 `@GetMapping` 注解来定义一个处理该请求的方法。类似下面的代码片段：

@Controller
@RequestMapping("/api")
public class ApiController {

    @GetMapping("/doc.html")
    public String swaggerDoc() {
        // 处理请求的逻辑
        return "doc"; // 返回对应的视图
    }
}

上述代码中，`/api/doc.html` 请求会被映射到 `swaggerDoc` 方法上，你可以在该方法中处理该请求，并返回对应的视图。

如果你使用的是其他后端框架，可以参考相应框架的文档查找类似的路由定义方法。

另外，确保你的 Swagger 文档文件 `doc.html` 在正确的位置，并且可以被访问到。

如果以上方法都没有解决问题，还可能是其他配置或者代码问题导致的。在进一步排查之前，你可以提供更多关于你的后端框架、代码和配置的信息，以便我们能够给出更具体的建议。