如何让空列表或null对象返回204 No Content而非200状态码
空列表/null返回204 No Content实现方案
核心逻辑是在响应返回前统一做判断,命中空值场景时直接修改状态码并清空响应体,避免默认走200+空数组的逻辑。
- Node/NestJS 技术栈实操:
注册全局响应拦截器,拦截所有返回值做判断,示例代码:
拦截器注册到全局后即可生效,无需单独修改每个接口的逻辑。@Injectable() export class BlankResponseInterceptor implements NestInterceptor { intercept(context: ExecutionContext, next: CallHandler) { const response = context.switchToHttp().getResponse(); return next.handle().pipe( map((data) => { // 命中空值场景:null/undefined/空数组 if (data == null || (Array.isArray(data) && data.length === 0)) { response.status(204); return; } return data; }), ); } } - Java/SpringBoot 技术栈实操:
实现全局ResponseBodyAdvice,在响应写入前判断返回值,命中空值时直接设置204状态码,返回null即可,框架会自动处理无内容响应。 - 注意事项:
- 204状态码规范要求响应体必须为空,不要额外返回
[]、{}这类内容 - 可以给拦截器加白名单,避免覆盖部分需要主动返回200空内容的接口
- 204状态码规范要求响应体必须为空,不要额外返回
内容的提问来源于stack exchange,提问作者Aykut Suleyman
相关产品推荐
相关产品推荐

