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
相关产品推荐
相关产品推荐

