@RestController返回MappingJacksonValue时如何正确返回404状态码

最佳实践方案 #

Spring生态中不抛出异常返回404的首选方案是使用ResponseEntity封装响应结果，它可以同时指定HTTP状态码、响应头和响应体，完全符合REST接口设计规范。下面是不同场景的实现方式：

方案1：单接口直接返回ResponseEntity（最常用，无额外改造） #

直接修改方法返回值为ResponseEntity<MappingJacksonValue>，查询结果为空时直接返回404状态，存在时正常返回序列化结果即可，代码示例：

public ResponseEntity<MappingJacksonValue> getUserView(User viewer, Long vieweeid) {
    User viewee = getUser(vieweeid);
    // 直接返回404，无需抛异常
    if(viewee == null) {
        return ResponseEntity.notFound().build();
    }
    final MappingJacksonValue result = new MappingJacksonValue(viewee);
    Class view = Views.Minimal.class;
    if(viewer.getId().equals(viewee.getId())) {
        view = Views.Full.class;
    }
    // ...省略其他逻辑...
    result.setSerializationView(view);
    // 正常返回200状态和响应体
    return ResponseEntity.ok(result);
}

这个方案的优势是无侵入、逻辑清晰，不需要额外定义全局处理类，适合只有少数接口需要做类似判断的场景。

方案2：全局统一处理（适合多接口复用） #

如果项目中大量接口都存在「查询实体为空返回404」的逻辑，可以统一封装处理避免重复代码：

1. 首先将查询方法改造为返回Optional<User>：

public Optional<User> getUser(Long id) {
    // 原有查询逻辑，为空返回Optional.empty()
}

2. 可以在Controller层用链式调用简化写法：

public ResponseEntity<MappingJacksonValue> getUserView(User viewer, Long vieweeid) {
    return getUser(vieweeid)
        .map(viewee -> {
            final MappingJacksonValue result = new MappingJacksonValue(viewee);
            Class view = Views.Minimal.class;
            if(viewer.getId().equals(viewee.getId())) {
                view = Views.Full.class;
            }
            // ...省略其他逻辑...
            result.setSerializationView(view);
            return ResponseEntity.ok(result);
        })
        .orElseGet(() -> ResponseEntity.notFound().build());
}

这种写法更简洁，也能避免空指针风险。

补充说明 #

如果你需要在返回404的同时携带自定义提示信息，可以修改404返回的逻辑：

return ResponseEntity.status(HttpStatus.NOT_FOUND).body("entity not found");

如果返回的信息需要统一格式，也可以自定义通用响应体类封装状态码、提示信息和数据。

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