Spring Native+GraalVM环境下MultipartFile文件上传报400错误

报错信息 #

No primary or single public constructor found for interface org.springframework.web.multipart.MultipartFile - and no default constructor found either

问题场景 #

基于Spring Native技术栈，使用GraalVM将代码编译为二进制文件后，调用文件上传接口（@PostMapping("/upload")）时返回400 Bad Request，触发上述报错。

核心原因 #

GraalVM的AOT（提前编译）机制会在编译期确定所有需要加载的类及依赖，而MultipartFile是接口，Spring处理文件上传时会动态实例化其具体实现类（如StandardMultipartFile）。由于Spring Native默认未将这些实现类的反射信息注册到AOT元数据中，导致运行时无法实例化MultipartFile对象，进而抛出构造函数不存在的错误。

解决方法 #

方法1：添加反射绑定注解 #

在Controller类上添加@RegisterReflectionForBinding注解，指定MultipartFile的实现类，让GraalVM编译时包含该类的反射信息：

@RestController
@RequestMapping("/api/blob")
@RequiredArgsConstructor
@Slf4j
@RegisterReflectionForBinding(StandardMultipartFile.class)
public class MyBlobRestController {
    // 原有代码保持不变
}

若使用Apache Commons FileUpload的实现，替换为CommonsMultipartFile.class即可

方法2：手动配置原生镜像元数据 #

在项目的src/main/resources/META-INF/native-image目录下创建reflect-config.json文件，添加以下内容手动注册反射信息：

[
  {
    "name": "org.springframework.web.multipart.support.StandardMultipartFile",
    "allDeclaredConstructors": true,
    "allPublicConstructors": true,
    "allDeclaredMethods": true,
    "allPublicMethods": true
  }
]

方法3：启用自动元数据收集 #

在application.properties中开启Spring Native的代理模式，运行时自动收集所需的元数据，后续可将生成的配置文件复用在AOT编译中：

spring.native.mode=agent

方法4：确认依赖完整性 #

确保项目依赖中已正确引入Spring Web模块，Spring Native会自动关联Multipart相关支持：

<!-- Maven示例 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>spring-native</artifactId>
    <version>${spring-native.version}</version>
</dependency>

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