You need to enable JavaScript to run this app. Micronaut声明式客户端MultipartBody多文件上传报引用计数异常
优惠活动
大模型
产品
解决方案
定价
更多

Micronaut声明式客户端MultipartBody多文件上传报引用计数异常

问题核心成因

抛出的io.netty.util.IllegalReferenceCountException异常本质是Netty池化ByteBuf内存被重复释放,结合堆栈定位到具体触发原因如下:

  • 重复调用文件字节读取接口:堆栈显示异常直接触发于ProductManagerController的file.getBytes()调用。Micronaut内置的NettyCompletedFileUpload实现中,每次执行getBytes()操作后,会对内部关联的Netty ByteBuf执行release操作释放内存,第一次调用完成后该ByteBuf的引用计数就会归零;代码中连续两次调用file.getBytes()组装同一文件的两个分片,第二次调用时就会尝试对已经释放的内存执行release,直接抛出引用计数异常。
  • 声明式客户端注解配置颠倒:@Post注解中consumes代表客户端请求发送负载的MIME类型,produces代表客户端期望接收的响应MIME类型。现有代码写为consumes = MediaType.TEXT_PLAIN, produces = MediaType.MULTIPART_FORM_DATA,完全和实际逻辑相反,会导致请求头Content-Type配置错误,无法正确触发multipart请求的序列化逻辑。
  • 接收端参数绑定逻辑不匹配:客户端发送的多分片multipart请求包含文件流和普通表单参数,目标端控制器直接将流式的Publisher<CompletedFileUpload>和平铺的String id作为独立参数,不符合Micronaut的multipart参数绑定规则,会出现参数无法正常解析的问题。
修复方案
  • 避免重复调用文件的getBytes方法:将读取到的文件字节缓存为局部变量,后续组装分片时统一使用缓存的字节数组,不要重复触发文件的字节读取操作,参考实现如下:
@Override
public String post(CompletedFileUpload file) throws IOException {
    // 仅读取一次字节内容,缓存复用
    byte[] fileBytes = file.getBytes();
    MultipartBody requestBody = MultipartBody.builder()
            .addPart("file", file.getFilename(), MediaType.MULTIPART_FORM_DATA_TYPE, fileBytes)
            .addPart("file", file.getFilename(), MediaType.MULTIPART_FORM_DATA_TYPE, fileBytes)
            .addPart("id", "asdasdsds")
            .build();
    return this.iProduct.post(requestBody);
}
  • 修正声明式客户端的注解配置,将consumes和produces的取值调换为和实际请求逻辑匹配的配置:
@Client("http://localhost:8080/product")
public interface IHttpClient {
    // 客户端发送multipart负载,期望接收text/plain类型响应
    @Post(consumes = MediaType.MULTIPART_FORM_DATA, produces = MediaType.TEXT_PLAIN)
    String post(@Body MultipartBody file);
}
  • 修正目标接收端的参数定义,统一使用MultipartBody接收所有分片内容,按需提取文件和普通表单参数:
@Controller("/product")
public class ProductController {
    @Post(consumes = MediaType.MULTIPART_FORM_DATA, produces = MediaType.TEXT_PLAIN)
    public String post(MultipartBody body) {
        // 从body中提取文件分片、id参数做业务处理
        String id = body.get("id", String.class).orElse(null);
        List<MultipartBody.Part> fileParts = body.getParts("file");
        // 业务处理逻辑
        return "success";
    }
}

注意:如果需要转发的文件体积较大,不建议直接将全部字节读入堆内存,可以直接将原始的CompletedFileUpload流转换为multipart分片传递,避免大文件造成内存溢出。

内容的提问来源于stack exchange,提问作者San Jaisy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 05:15:00