java - @ApiResponse 响应主体为空(Spring Boot)

Question

我正在寻找一种方法来告诉 swagger 某个 API 响应代码没有响应正文。例如，获取响应可以返回 200 代码以及实际对象作为响应，如果与传递的 ID 关联的对象不存在，则返回 404:

@ApiResponses(value = {
    @ApiResponse(responseCode = "200", description = "Object found"),
    @ApiResponse(responseCode = "404", description = "Invalid object ID", content = @Content)
})

这是我能想到的最接近的东西，但它并不完美，我仍然在 404 响应的描述下得到一个烦人的“媒体类型”。谢谢!

Answer 1

如果您未指定 content @ApiResponse 的属性注解 Controller 方法的返回类型将是您的响应内容。为了防止这种情况定义 content明确:

@ApiResponse(responseCode = "200", description = "OK",
             content = @Content(schema = @Schema(implementation = Void.class)))

或者您可以简单地返回 ResponseEntity<Void> .