如何泛化Spring控制器返回类型？无数据提示未显示求解

HTTP 204（NO_CONTENT）状态码的官方规范明确要求不包含响应体，因此你设置的"Content unavailable!"会被客户端（浏览器、接口测试工具等）直接忽略，这就是提示不显示的核心原因。

方案1：替换状态码，返回带响应体的结果 #

选择符合场景语义的状态码，比如200 OK（表示请求成功但无数据）或404 NOT_FOUND（表示用户资源不存在），然后正常返回提示文本：

@GetMapping("/users")
public ResponseEntity<Object> getAllUsers(){
    List<User> users = this.userRepository.findAll();

    if(users.isEmpty()){
        // 用200返回提示，适合"请求成功但无数据"的场景
        return ResponseEntity.status(HttpStatus.OK).body("Content unavailable!");
        // 或用404，适合"用户列表资源不存在"的语义
        // return ResponseEntity.status(HttpStatus.NOT_FOUND).body("No users found!");
    }

    return ResponseEntity.status(HttpStatus.OK).body(users);
}

方案2：统一响应格式（推荐） #

定义通用的响应DTO，统一返回结构，避免不同场景下返回类型不一致的问题，同时兼容有/无数据的情况：

1. 先创建通用响应类：

public class ApiResponse<T> {
    private int status;
    private String message;
    private T data;

    // 构造方法、getter、setter
    public ApiResponse(int status, String message, T data) {
        this.status = status;
        this.message = message;
        this.data = data;
    }
}

2. 修改控制器代码：

@GetMapping("/users")
public ResponseEntity<ApiResponse<List<User>>> getAllUsers(){
    List<User> users = this.userRepository.findAll();

    if(users.isEmpty()){
        return ResponseEntity.ok(new ApiResponse<>(HttpStatus.OK.value(), "Content unavailable!", null));
    }

    return ResponseEntity.ok(new ApiResponse<>(HttpStatus.OK.value(), "Success", users));
}

这种方式让客户端处理逻辑更统一，也更符合REST接口的规范设计。

方案3：通过响应头传递提示（不推荐） #

如果一定要保留204状态码，可以将提示信息放在响应头中，但需要客户端主动读取头信息才能获取：

@GetMapping("/users")
public ResponseEntity<Object> getAllUsers(){
    List<User> users = this.userRepository.findAll();

    if(users.isEmpty()){
        return ResponseEntity.status(HttpStatus.NO_CONTENT)
                .header("X-Message", "Content unavailable!")
                .build();
    }

    return ResponseEntity.status(HttpStatus.OK).body(users);
}

内容的提问来源于stack exchange，提问作者Ashwin