Java Byte数组扩容及Spring Boot 3大文件上传问题求助

首先明确：Java中byte数组的长度受限于int类型的最大值（2147483647，即2^31-1），这是语言层面的硬性限制，无法突破。你遇到的错误正是因为文件大小超过了这个值，file.getBytes()试图创建超出int范围的数组导致的。针对Spring Boot 3处理2GB-5GB大文件，推荐以下几种方案：

1. 使用流式读取替代一次性加载到内存 #

不要调用MultipartFile.getBytes()，改用getInputStream()逐块读取文件内容，边读边处理（比如写入磁盘、上传到对象存储等），避免一次性占用大量内存。示例代码：

@PostMapping("/upload")
public String handleLargeFileUpload(@RequestParam("file") MultipartFile file) throws IOException {
    try (InputStream inputStream = file.getInputStream();
         FileOutputStream outputStream = new FileOutputStream("/path/to/save/" + file.getOriginalFilename())) {
        byte[] buffer = new byte[8192]; // 8KB缓冲块
        int bytesRead;
        while ((bytesRead = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }
    }
    return "File uploaded successfully";
}

2. 配置Spring Multipart参数，避免内存溢出 #

Spring Boot默认会将小文件加载到内存，大文件写入临时磁盘文件，但需要调整参数确保大文件能被正确处理：

在application.properties或application.yml中添加：

# 设置单个文件最大大小
spring.servlet.multipart.max-file-size=5GB
# 设置整个请求最大大小
spring.servlet.multipart.max-request-size=5GB
# 文件大小超过此阈值时，写入磁盘临时文件（否则存在内存）
spring.servlet.multipart.file-size-threshold=10MB
# 可选：指定临时文件存储路径
spring.servlet.multipart.location=/temp/uploads

这些配置确保大文件不会被强制加载到内存，而是先写入磁盘临时文件，后续处理时再流式读取。

3. 切换到Spring WebFlux进行非阻塞流式上传 #

如果你的项目可以基于Spring WebFlux构建，它天生支持非阻塞的大文件上传，无需担心内存占用问题。示例代码：

@PostMapping("/upload")
public Mono<String> handleLargeFileUpload(@RequestPart("file") FilePart filePart) {
    Path savePath = Paths.get("/path/to/save/" + filePart.filename());
    return filePart.transferTo(savePath)
            .then(Mono.just("File uploaded successfully"));
}

WebFlux的FilePart会自动流式处理文件内容，不会一次性加载到内存。

4. 直接处理Servlet原始请求（底层方案） #

如果需要更底层的控制，可以直接获取HttpServletRequest的输入流进行流式读取：

@PostMapping("/upload")
public String handleLargeFileUpload(HttpServletRequest request) throws IOException {
    try (InputStream inputStream = request.getInputStream();
         FileOutputStream outputStream = new FileOutputStream("/path/to/save/large-file.bin")) {
        byte[] buffer = new byte[16384]; // 16KB缓冲块
        int bytesRead;
        while ((bytesRead = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }
    }
    return "File uploaded successfully";
}

这种方式跳过Spring的Multipart封装，直接处理原始请求流，适合极端场景。

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