Spring Boot 下如何将本地文件转为MultipartFile调用Feign上传接口

具体操作步骤 #

1. 修正现有Feign接口的参数注解 #

现有代码中给MultipartFile加@RequestBody的写法会导致Feign序列化错误，multipart/form-data协议下的文件参数应使用@RequestPart标记，修正后的接口代码：

@FeignClient(name = "abc-file-upload", url ="https://abc.xyz.app")
public interface ABCFeignClient {
    String AUTH_TOKEN = "Authorization";
    @PostMapping(value = "/api/v1/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    UploadFileResponse uploadFile(@RequestPart("file") MultipartFile multipartFile, 
                                  @RequestHeader(AUTH_TOKEN) String apiKey);
}

注意：spring-cloud-starter-openfeign 默认已集成Multipart类型参数的序列化模块，保证项目正常引入依赖即可识别文件类型参数，无需额外配置。

2. 编写自定义MultipartFile实现类 #

直接实现Spring的MultipartFile接口，绑定本地磁盘文件，替代测试环境专用的MockMultipartFile，避免生产环境依赖测试模块：

public class LocalMultipartFile implements MultipartFile {
    private final File localFile;
    private final String originalFilename;

    // 构造方法：传入本地文件的绝对路径
    public LocalMultipartFile(String filePath) {
        this.localFile = new File(filePath);
        if (!localFile.exists() || !localFile.isFile()) {
            throw new IllegalArgumentException("指定路径文件不存在或不是有效文件：" + filePath);
        }
        this.originalFilename = localFile.getName();
    }

    @Override
    public String getName() {
        return localFile.getName();
    }

    @Override
    public String getOriginalFilename() {
        return originalFilename;
    }

    @Override
    public String getContentType() {
        // 自动识别文件MIME类型
        try {
            return Files.probeContentType(localFile.toPath());
        } catch (IOException e) {
            return "application/octet-stream";
        }
    }

    @Override
    public boolean isEmpty() {
        return localFile.length() == 0;
    }

    @Override
    public long getSize() {
        return localFile.length();
    }

    @Override
    public byte[] getBytes() throws IOException {
        return Files.readAllBytes(localFile.toPath());
    }

    @Override
    public InputStream getInputStream() throws IOException {
        return new FileInputStream(localFile);
    }

    @Override
    public void transferTo(File dest) throws IOException, IllegalStateException {
        Files.copy(localFile.toPath(), dest.toPath());
    }
}

3. 业务层调用Feign接口 #

在需要触发上传的业务代码中，直接传入本地文件的绝对路径实例化自定义的MultipartFile对象，即可直接调用已有的Feign方法：

@Service
public class FileUploadService {
    @Autowired
    private ABCFeignClient abcFeignClient;

    public void uploadLocalFile() {
        String localFilePath = "/Users/pradeepkumar/Desktop/File_Download/file1.jpg";
        // 封装本地文件为MultipartFile对象
        MultipartFile file = new LocalMultipartFile(localFilePath);
        // 直接调用Feign接口
        UploadFileResponse response = abcFeignClient.uploadFile(file, "你的接口鉴权密钥");
    }
}

注意事项 #

• 运行Spring Boot服务的系统账号，需要对指定的本地文件路径拥有可读权限，否则会抛出文件找不到的IO异常。
• 不要在生产环境直接使用spring-test包下的MockMultipartFile，避免测试类依赖被打包到生产镜像中，引发不必要的类加载风险。
• 大文件上传时不要提前把全量文件读入内存，自定义MultipartFile的方法实现要以流读取为主，避免堆内存溢出。
• 检查Feign的全局配置，不要手动覆盖multipart请求的boundary参数，否则服务端会无法正确解析文件流。

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