SpringDoc OpenAPI 泛型返回值完美解决方案(最新推荐)

@Operation(summary = "查询所有医学系统")
@ApiResponse(responseCode = "200", description = "成功",
    content = @Content(schema = @Schema(implementation = R_MedicalSystemVO_List.class)))
@GetMapping("/systems")
public R<List<MedicalSystemVO>> listAllSystems() { ... }

@Data
@NoArgsConstructor
@AllArgsConstructor
@Schema(description = "统一接口应答封装")  // 不要固定 name
public class R<T> implements Serializable {
    @Schema(description = "业务状态码", example = "0")
    private int code;
    @Schema(description = "提示信息", example = "OK")
    private String msg;
    @Schema(description = "业务数据")
    private T data;
    @Schema(description = "响应时间")
    private LocalDateTime timestamp;
    // ... 静态方法
}

@Data
@NoArgsConstructor
@AllArgsConstructor
@Schema(name = "MedicalSystemVO", description = "医学系统视图对象")
public class MedicalSystemVO implements Serializable {
    @Schema(description = "系统ID", example = "1")
    private Integer id;
    @Schema(description = "系统名称", example = "神经系统")
    private String systemName;
    @Schema(description = "描述", example = "主要作用...")
    private String description;
}

@Operation(summary = "查询医学系统")
@ApiResponses(value = {
    @ApiResponse(responseCode = "200", description = "成功",
        content = @Content(mediaType = "application/json",
            schema = @Schema(implementation = MedicalSystemListResponse.class)))
})
@GetMapping("/systems")
public R<List<MedicalSystemVO>> listAllSystems() {
    return R.ok(systems);
}
// 为每个泛型组合创建响应 Schema 类
@Schema(name = "MedicalSystemListResponse", description = "医学系统列表响应")
public static class MedicalSystemListResponse extends R<List<MedicalSystemVO>> {}