如何解决Swagger对ResponseEntity泛型类型推断不准确的问题

@ApiOperation(value = "show code")
@GetMapping("/showActivationCode")
@ApiResponses(
        {
                @ApiResponse(code = 200, message = "OK"),
                @ApiResponse(code = 403, message = "Not login"),
        })
public ResponseEntity showActivationCode() { // 注意：此处未指定泛型类型
    if (session.getAttribute("isAdmin") == "1") {
        return ResponseEntity.status(200).body(userService.getActiveCode());
    } else {
        return ResponseEntity.status(403).body("Not login");
    }
}

{
  "body": {},
  "statusCode": "ACCEPTED",
  "statusCodeValue": 0
}

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiResponse;
import io.swagger.annotations.ApiResponses;

import javax.servlet.http.HttpSession;
import java.util.Collections;
import java.util.List;

// 假设 ActiveCode 和 UserService 已经定义
// class ActiveCode { String code; String isAdmin; String name; }
// class UserService { List<ActiveCode> getActiveCode(); }

@RestController
public class ActivationCodeController {

    private final UserService userService;
    private final HttpSession session;

    public ActivationCodeController(UserService userService, HttpSession session) {
        this.userService = userService;
        this.session = session;
    }

    @ApiOperation(value = "显示激活码")
    @GetMapping("/showActivationCode")
    @ApiResponses(
            {
                    @ApiResponse(code = 200, message = "成功获取激活码列表", response = ActiveCode.class, responseContainer = "List"),
                    @ApiResponse(code = 403, message = "未登录或无权限")
            })
    public ResponseEntity<List<ActiveCode>> showActivationCode() { // 明确指定泛型类型为 List<ActiveCode>
        if ("1".equals(session.getAttribute("isAdmin"))) { // 推荐使用 equals 进行字符串比较
            return ResponseEntity.status(200).body(userService.getActiveCode());
        } else {
            // 当无权限时，返回403状态码，并提供一个空列表或null作为响应体，
            // 以保持与泛型类型 List<ActiveCode> 的一致性。
            // 此时，Swagger仍能显示List<ActiveCode>的结构，但实际返回为空。
            return ResponseEntity.status(403).body(Collections.emptyList());
            // 或者返回 null，但可能需要额外处理以避免客户端NPE
            // return ResponseEntity.status(403).body(null);
        }
    }
}

{
  "body": [
    {
      "code": "string",
      "isAdmin": "string",
      "name": "string"
    }
  ],
  "statusCode": "OK",
  "statusCodeValue": 200
}

public class ErrorResponse {
    private int code;
    private String message;
    private String details;

    // 构造函数、Getter和Setter
    public ErrorResponse(int code, String message, String details) {
        this.code = code;
        this.message = message;
        this.details = details;
    }
    // ...
}

// 如果希望在错误情况下返回不同类型的数据，则方法签名需要更灵活，
// 或者在@ApiResponses中为不同状态码指定不同的响应模型。
// 但如果方法签名固定为 ResponseEntity<List<ActiveCode>>，则必须保持返回类型一致。
// 此时，通常会通过异常处理机制来统一处理错误响应。

// 假设我们允许在403时返回 ErrorResponse，则方法签名可能需要调整为更通用的类型，
// 或在@ApiResponses中明确指出403的响应类型。
// 鉴于本教程主要解决泛型类型推断问题，我们继续保持 List<ActiveCode> 作为主要返回类型。
// 如果确实需要在403返回ErrorResponse，则需要重新考虑API设计，例如：
/*
@ApiResponses(
        {
                @ApiResponse(code = 200, message = "成功获取激活码列表", response = ActiveCode.class, responseContainer = "List"),
                @ApiResponse(code = 403, message = "未登录或无权限", response = ErrorResponse.class)
        })
public ResponseEntity<?> showActivationCode() { // 使用通配符或Object作为泛型
    if ("1".equals(session.getAttribute("isAdmin"))) {
        return ResponseEntity.status(200).body(userService.getActiveCode());
    } else {
        return ResponseEntity.status(403).body(new ErrorResponse(403, "Forbidden", "You are not authorized to access this resource."));
    }
}
*/
// 然而，为了保持单一响应类型，推荐在错误情况下返回与成功响应类型兼容的空数据，
// 或通过全局异常处理器来统一处理并返回ErrorResponse，此时业务方法仍返回期望的类型。

// 保持原教程的思路，即方法签名固定为 ResponseEntity<List<ActiveCode>>
// 此时，为了Swagger文档的统一性，403也返回空列表是可行的折衷方案。