Spring Boot调用IOUtils.toByteArray报错：方法toByteArray(InputStream)未定义

数据老陈

2026-5-29

解决IOUtils.toByteArray方法未定义的问题

嘿，这个错误我太熟悉了！你碰到的The method toByteArray(InputStream) is undefined for the type IOUtils，核心原因要么是没导入正确的IOUtils类，要么是项目里缺少Apache Commons IO的依赖。咱们一步步来解决：

1. 先确认导入的IOUtils类

你要确保代码里导入的是Apache Commons IO的IOUtils，而不是其他框架的同名类：

import org.apache.commons.io.IOUtils;

很多项目里可能会有其他包也叫IOUtils（比如Spring的某些工具类），但只有Apache的这个才有toByteArray(InputStream)方法。

2. 添加Apache Commons IO依赖

如果你的项目里还没加这个依赖，得补上：

Maven项目（pom.xml）

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.15.1</version> <!-- 用最新稳定版即可 -->
</dependency>

Gradle项目（build.gradle）

implementation 'commons-io:commons-io:2.15.1'

3. 备选方案：不用第三方库，用Java原生API实现

如果不想引入额外依赖，也可以用Java自带的ByteArrayOutputStream来实现相同功能，代码如下：

@GetMapping(value = "/get-file", produces = MediaType.APPLICATION_OCTET_STREAM_VALUE)
public @ResponseBody byte[] getFile() throws IOException {
    try (InputStream in = getClass().getResourceAsStream("/com/baeldung/produceimage/data.txt");
         ByteArrayOutputStream out = new ByteArrayOutputStream()) {
        byte[] buffer = new byte[1024];
        int length;
        while ((length = in.read(buffer)) != -1) {
            out.write(buffer, 0, length);
        }
        return out.toByteArray();
    }
}

这里用了try-with-resources语法，能自动关闭流，避免资源泄漏。