Micronaut HttpServerFilter问题：请求体为何始终为空？

核心原因 #

Micronaut中HttpServerFilter获取请求体为空，主要是因为：

1. 请求体的Reactive流特性：Micronaut的请求体基于Reactive流实现，默认只能被消费一次。如果下游控制器先读取了请求体，过滤器中再尝试读取时，流已耗尽，自然返回空。而HttpClientFilter是在请求发送前处理，此时请求体还未被消费，所以能正常读取。
2. GET/DELETE请求的默认行为：默认情况下，Micronaut不会解析GET、DELETE这类请求的请求体，即使你发送了体，框架也不会自动解析，导致过滤器中读取不到。

解决方案 #

1. 缓冲请求体以支持多次读取

在过滤器中，将原始请求包装为BufferingHttpRequest，这样请求体就可以被多次读取，既不影响下游控制器处理，也能在过滤器中记录内容：

import io.micronaut.http.HttpRequest;
import io.micronaut.http.MutableHttpResponse;
import io.micronaut.http.annotation.Filter;
import io.micronaut.http.filter.HttpServerFilter;
import io.micronaut.http.filter.ServerFilterChain;
import io.micronaut.http.server.util.HttpRequestUtils;
import org.reactivestreams.Publisher;

@Filter("/**")
public class RequestLoggingFilter implements HttpServerFilter {

    @Override
    public Publisher<MutableHttpResponse<?>> doFilter(HttpRequest<?> request, ServerFilterChain chain) {
        // 将请求包装为可缓冲的实例，允许多次读取请求体
        HttpRequest<?> bufferedRequest = HttpRequestUtils.buffer(request);
        
        // 读取请求体，根据实际需求转换类型（比如String、自定义DTO等）
        String requestBody = bufferedRequest.getBody(String.class).orElse("无请求体");
        System.out.println("请求路径: " + request.getPath() + "，请求体: " + requestBody);
        
        // 继续传递缓冲后的请求到下游
        return chain.proceed(bufferedRequest);
    }
}

2. 配置允许读取GET/DELETE请求的请求体

如果需要读取GET、DELETE请求的请求体，需要在配置文件（application.yml或application.properties）中添加以下配置：

micronaut:
  server:
    read-body-for-all-requests: true

额外注意事项 #

• 确保过滤器的优先级设置合理，避免在下游已经消费请求体后才执行（可以通过@Filter的order属性调整顺序）。
• 如果请求体是二进制数据或大文件，注意缓冲可能带来的内存占用问题，根据实际场景调整处理方式。

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