springboot，spring框架返回204 status code的时候，会吞掉返回值

背景

发现有个有意思的现象，就是当你的接口返回204的 HTTP status code 的时候，会自动把 response body 吃掉，即使代码里是有返回的。例如
（其实204本身就是NO_CONTENT的意思，不过我是真没想到真干掉了返回）

@PostMapping("/stu")
    public Stu stu(HttpServletResponse resp) {
        resp.setStatus(204);
        Stu stu = new Stu();
        stu.setName("Stone");
        return stu;
    }

    @Data
    public static class Stu {
        private String name;
    }
1
2
3
4
5
6
7
8
9
10
11
12

注意：如果去掉204那行，则返回200，则

应用

其实，比如有个接口，按照restful的设计规则是有这样的需求的：如果创建了user就返回200（或者201 created），如果修改了user就返回204（no_content）

但是你的java的层面总是必须有个返回类型，不能用void，那就是在204的情况下也得在语法的层面上进行return，那这个204的行为就也算符合预期。

你有可能看到代码，在204的就 return null; 其实并不是因为你 return null 而导致 response body 无任何内容，其实是只要是204就会自动没有任何内容。