解决报错multipart/form-data;boundary=----WebKitFormBoundaryRAYPKeHKTYSNdzc1;charset=UTF-8' not supported

最新推荐文章于 2025-09-17 18:04:58 发布
原创 最新推荐文章于 2025-09-17 18:04:58 发布 · 1.8w 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文详细解析了在使用Spring框架进行文件上传时遇到的415错误，该错误通常由于不支持的媒体类型引发。文章通过分析错误日志，发现Spring无法正确解析multipart/form-data请求体，导致上传失败。通过将@RequestBody注解替换为@RequestParam，成功解决了这一问题。

在文件上传功能时报415错误

{
"timestamp":"2020-02-26T09:39:03.733+0000",

"status":415,

"error":"Unsupported Media Type",

"message":"Content type 'multipart/form-data;boundary=----WebKitFormBoundaryBStyx68ADraw6UJb;charset=UTF-8' not supported",

"trace":"org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'multipart/form-data;boundary=----WebKitFormBoundaryBStyx68ADraw6UJb;charset=UTF-8' not supported\r\n\tat org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodArgumentResolver.readWithMessageConverters(AbstractMessageConverterMethodArgumentResolver.java:224)\r\n\tat org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyMethodProcessor.readWithMessageConverters(RequestResponseBodyMethodProcessor.java:157)\r\n\tat org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyMethodProcessor.resolveArgument(RequestResponseBodyMethodProcessor.java:130)\r\n\tat org.springframework.web.method.support.HandlerMethodArgumentResolverComposite.resolveArgument(HandlerMethodArgumentResolverComposite.java:124)\r\n\tat org.springframework.web.method.support.InvocableHandlerMethod.getMethodArgumentValues(InvocableHandlerMethod.java:165)\r\n\tat org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:138)\r\n\tat org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:102)\r\n\tat org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:895)\r\n\tat org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:800)\r\n\tat org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:87)\r\n\tat org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1038)\r\n\tat org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:942)\r\n\tat org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:998)\r\n\tat org.springframework.web.servlet.FrameworkServlet.doPost(FrameworkServlet.java:901)\r\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:660)\r\n\tat org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:875)\r\n\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:741)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\n\tat org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\n\tat org.springframework.web.filter.RequestContextFilter.doFilterInternal(RequestContextFilter.java:99)\r\n\tat org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\n\tat org.springframework.web.filter.FormContentFilter.doFilterInternal(FormContentFilter.java:92)\r\n\tat org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\n\tat org.springframework.web.filter.HiddenHttpMethodFilter.doFilterInternal(HiddenHttpMethodFilter.java:93)\r\n\tat org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\n\tat org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:200)\r\n\tat org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\n\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\n\tat org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:199)\r\n\tat org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:96)\r\n\tat org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:490)\r\n\tat org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:139)\r\n\tat org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:92)\r\n\tat org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:74)\r\n\tat org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:343)\r\n\tat org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:408)\r\n\tat org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:66)\r\n\tat org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:770)\r\n\tat org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1415)\r\n\tat org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49)\r\n\tat java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)\r\n\tat java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)\r\n\tat org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)\r\n\tat java.lang.Thread.run(Thread.java:745)\r\n","path":"/xmanagement/reportCenter/reportManagement/businessView/uploadIReport"}

原来的java文件 

    /**
     * 文件上传接口
     *
     * @param file
     * @return
     */
    @PostMapping("uploadIReport")
    public SimpleResult upload(@RequestParam("file") MultipartFile file, @RequestBody 
       Map<String, String> params) {
        try {
            businessViewBusiness.executeIReportData(file, params);
        } catch (Exception e) {
            e.printStackTrace();
            return new SimpleResult(-1, e.getMessage());
        }
        return new SimpleResult(0, "数据上传成功！");
    }

改后的java文件，将@RequestBody 换成@RequestParam解决

    /**
     * 文件上传接口
     *
     * @param file
     * @return
     */
    @PostMapping("uploadIReport")
    public SimpleResult upload(@RequestParam("file") MultipartFile file, @RequestParam
       Map<String, String> params) {
        try {
            businessViewBusiness.executeIReportData(file, params);
        } catch (Exception e) {
            e.printStackTrace();
            return new SimpleResult(-1, e.getMessage());
        }
        return new SimpleResult(0, "数据上传成功！");
    }

 

全网完美地解决Content type ‘multipart/form-data；boundary=----------0467042；charset=UTF-8‘ not supported)的问题
念兮为美
12-09 3万+
全网完美解决Content type 'multipart/form-data;boundary=--------------------------036764477110441760467042;charset=UTF-8' not supported
multipart/form-data；boundary=----WebKitFormBoundaryRAYPKeHKTYSNdzc1；charset=UTF-8‘ not supporte
oscar999的专栏
12-04 4258
问题： 使用Spring Boot文件上传时出错， 错误信息： multipart/form-data;boundary=----WebKitFormBoundaryRAYPKeHKTYSNdzc1;charset=UTF-8' not supported 发生场景： 上传文件时， 通过Form Submit 传递参数， 参数类型包括String 类型和文件类型， 在Spring中的参数自动匹配使用如下： upload(@RequestParam("files") MultipartFile[] fi.
理解 multipart/form-data 中的 boundary：文件上传的关键
南部余额的博客
09-17 502
multipart/form-data中的boundary是文件上传的关键分隔符。它作为HTTP请求头中的唯一标识字符串（如----WebKitFormBoundaryEBDscQO08JaFZOy6），用于分隔请求体中的不同数据部分，包括文本字段和文件数据。boundary保证了二进制数据不会与字段分隔符冲突，支持混合类型数据上传，并确保服务器能正确解析请求。每次请求生成的随机boundary前缀保证了唯一性，使多文件上传和复杂表单提交成为可能，是可靠文件传输的基础机制。
文件上传报HttpMediaTypeNotSupportedException: Content type ‘multipart/form-data；boundary=*****
a59457asdf的博客
01-25 3415
在做文件上传时，采用@RequestBody接受映射参数，在如下代码测试时，出现报错 @RequestMapping(value = "/upload", method =RequestMethod.POST) public String upload(@RequestParam("file") MultipartFile file, @RequestBody @Valid FileVO fileVO) { ... } ...
Controller报错：Content type ‘multipart/form-data；boundary=----WebKitFormBoundaryxxxx not supported
心之所往 码之所向
07-08 2万+
报错详情： Unsupported Media Type 以及Content type 'multipart/form-data;boundary=----WebKitFormBoundaryXXXXXXXXXX;charset=UTF-8' not supported 示例： /** * 此接口会产生以上的报错 */ @PostMapping("sample") public void samp...
multipart form-data boundary 说明
weixin_30547797的博客
09-12 1446
含义 ENCTYPE="multipart/form-data" 说明： 通过 http 协议上传文件 rfc1867协议概述，jsp 应用举例，客户端发送内容构造1、概述在最初的 http 协议中，没有上传文件方面的功能。 rfc1867 (http://www.ietf.org/rfc/rfc1867.txt) 为 http 协议添加了这个功能。客户端的浏览器，如 Microsoft IE,...
上传文件报错：Content type ‘multipart/form-data；boundary=----WebKitFormBoundarypJygPIIxqzTHmtkQ；charset=...
u014212540的博客
04-05 8601
ReponseBody不支持form-data，所以要接收带有文件的form-data有3种方式。错误写法（@RequestBody不支持form-data，这种写法接收不到参数）方式二（前端要把其他参数打包成json字符串）
Content type ‘multipart/form-data；boundary=---；charset=UTF-8‘ not supported问题解决
道阻且长,行则将至 行而不辍,未来可期
12-05 9853
目录 前言： 1、后端代码逻辑： 2、前端入参如下： 前言： 前提主要是前端需要上传一个文件然后同时传进来一个参数id，可是经常奔溃，最后解决了；应该是前端传值到data里面 1、后端代码逻辑： @ApiOperation(value = " 5、添加文件,仅支持上传到三级目录下图片") @PostMapping("/pic/addFiles") public ApiResponse addFiles( @ApiParam("当前文件夹的id"
【SpringBoot】 解决报错Content type ‘multipartform-data； boundary=...； charset=UTF-8‘ not supported
m0_74823983的博客
01-21 1152
RequestParam注解用来接收请求url后面的参数，或者Content-Type为multipart/form-data、application/x-www-form-urlencoded时的http body数据。例如，如果你发送一个JSON格式的数据到服务器，可以创建一个对应的Java类，并使用@RequestBody来将JSON数据映射到这个类的对象上。总的来说，@RequestParam注解用于获取简单的键值对数据，而@RequestBody注解用于将请求体映射到复杂的数据对象。
【Spring】上传文件的同时加参数报错 Content type multipart/form-data；boundary not supported
九师兄
06-29 699
去掉@RequestBody注解就行了。
前端上传文件， Content-Type: multipart/form-data； boundary=----WebKitFormBoundarywd2ZRr4Hlgf2m5MT ；
choujima的博客
08-29 5161
【代码】前端上传文件， Content-Type: multipart/form-data；
使用swagger上传文件时，报错 Content type 'multipart/form-data;boundary=----WebKitFormBoundaryRAYPKeHKTYSNdzc1
MisshqZzz的博客
11-01 1万+
使用swagger上传文件时，传参包括一个文件类型的数据，和一个对象实体，上传时报错： "timestamp": 1473349676109, "status": 415, "error": "Unsupported Media Type", "exception": "org.springframework.web.HttpMediaTypeNotSupportedExcepti.
Content type ‘multipart/form-data；boundary=----WebKitFormBoundaryF28EY3GDJybEjJPM；charset=UTF-8‘ not
一路向前
04-13 3507
文件上传报错。前端传的类型不对
org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'multipart/form-data;bounda
热门推荐
馒头花卷儿
07-26 3万+
最近在做一个图片上传，遇到这了这种情况，在入参 body 中同时传入文件和其它参数信息结果出现如题异常。 特别在此记录解决办法，以供大家参考。 method="post"必须事post方式。 public CommonResponse getHospitalInclude( @RequestBody RealUserRequest001 realUserRequest001, @Reque...
Content type ‘multipart/form-data；boundary=------57031299820747271；charset=UTF-8‘ not supported的解决方案
No8g攻城狮的博客
02-25 1万+
现象描述 org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'multipart/form-data;boundary=-------------------------- 570391279993820714772271;charset=UTF-8' not supported org.sp...
【SpringBoot】 解决报错Content type ‘multipart/form-data； boundary=...； charset=UTF-8‘ not supported
水w的博客
01-02 2937
解决报错
python 文件/图片上传 boundary=----WebKitFormBoundary.....
小王子博客
06-16 5140
python 图片/文件上传
Python爬虫关于网站上传图片： Content-Type: multipart/form-data； boundary=----WebKitFormBoundary****************
m0_72458808的博客
10-11 6745
boundary=----WebKitFormBoundary****************, 尝试这从其它返回的接口中也找不到它，然后使用 MultipartEncoder(fields=fields, boundary=boundary) 将我们要上传的图片参数，以及生成的boundary传入此类中， 然后使用返回的 m对象，调用器 content_type 属性，就能获取Content-Type 的值了， 这样，我们就能成功模拟发送请求了！我们也一度怀疑是否是在前端JS中生成的，不要着急！
关于content type‘multipart/form-data ...‘not support
m0_49215700的博客
12-16 7950
项目场景： 关于在使用springcloud，网关跳转指定服务显示错误信息 问题描述： Content type 'multipart/form-data;boundary=----WebKitFormBoundaryek7Ljn5odm2QALlC;charset=UTF-8' not supported 原因分析： 这是因为请求过来的参数是content-type:multipart/form-data,是表单形式提交过来的，所以问题出现在形参上，去掉形参上的注解即可完成（只需要以spri
Content type 'multipart/form-data;charset=UTF-8' not supported
最新发布
11-14
<think> 我们正在处理一个关于Spring Boot中上传文件时出现的错误：“Content type 'multipart/form-data;charset=UTF-8' not supported”。根据引用[1]和[2]，错误信息显示Spring Boot不支持给定的Content-Type。引用[3]指出，@RequestParam注解用于接收请求url?后面的参数，或者Content-Type为multipart/form-data、application/x-www-form-urlencoded时的http body数据。 问题分析： 通常，这个错误发生在使用Spring Boot处理文件上传时，可能的原因有： 1. 在控制器方法中，使用@RequestParam来接收文件，但没有正确配置multipart解析器。 2. 请求的Content-Type虽然为multipart/form-data，但可能因为某些配置问题导致Spring无法解析。 解决方案： 步骤1：添加必要的依赖（如果使用Maven） 确保在pom.xml中包含了spring-boot-starter-web依赖，它已经包含了处理multipart请求的库。但如果你需要额外的配置，可以添加commons-fileupload依赖（不过Spring Boot默认使用Servlet 3.0的multipart支持，所以通常不需要）。 步骤2：配置multipart属性（可选） 在application.properties或application.yml中配置multipart相关属性，例如： ```properties spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB ``` 步骤3：检查控制器方法 确保在控制器方法中，使用@RequestParam("file") MultipartFile file来接收文件，并且方法使用@PostMapping注解，同时确保请求的Content-Type为multipart/form-data。 但是，根据引用[3]，这个错误可能是因为使用了@RequestParam注解，但请求的Content-Type并不是它能够处理的。实际上，对于multipart/form-data请求，Spring MVC要求使用MultipartFile类型来接收文件。 步骤4：如果使用@RequestParam注解，确保参数名与前端表单中的文件字段名一致。 步骤5：如果以上步骤都正确，那么可能是Spring的multipart解析器没有正确配置。在Spring Boot中，默认是启用的。但是，如果自定义了MultipartResolver，需要确保bean的名字为"multipartResolver"（因为Spring MVC会按这个名字查找）。例如： ```java @Bean public MultipartResolver multipartResolver() { CommonsMultipartResolver resolver = new CommonsMultipartResolver(); // 设置一些属性 return resolver; } ``` 注意：这里返回的bean名称必须是multipartResolver（方法名也是multipartResolver），否则Spring MVC会使用默认的解析器。 步骤6：如果使用的是Servlet 3.0容器（如Tomcat），还可以尝试在启动类上添加@EnableWebMvc注解，但Spring Boot会自动配置，所以通常不需要。 另一种可能：如果请求中包含了JSON数据和其他类型的混合，可能需要使用@RequestPart代替@RequestParam。但是，对于普通的文件上传，@RequestParam就足够了。 根据错误信息，我们看到boundary字符串和charset=UTF-8，这是multipart请求的正常格式。因此，问题可能在于Spring Boot没有正确解析这个请求，可能是因为没有配置multipart解析器，或者配置有误。 但是，在Spring Boot中，默认已经配置了MultipartAutoConfiguration，所以通常不需要额外配置。所以，重点检查控制器的参数注解和类型。 如果问题仍然存在，请检查是否在控制器方法上错误地使用了consumes属性，比如： ```java @PostMapping(value = "/upload", consumes = MediaType.APPLICATION_JSON_VALUE) ``` 这样会限制只接收JSON请求，而文件上传的请求是multipart/form-data，所以会导致不支持的媒体类型错误。 因此，确保consumes属性没有限制为其他类型，或者不指定consumes属性（默认可接受所有类型）。 总结步骤： 1. 检查依赖：确保有spring-boot-starter-web。 2. 检查配置：在application.properties中配置multipart（可选，但建议设置大小限制）。 3. 检查控制器：使用MultipartFile和@RequestParam，且参数名匹配，不要使用consumes限制为其他类型。 4. 避免自定义MultipartResolver，或者确保自定义的bean名称为multipartResolver。 如果按照以上步骤，问题应该可以解决。 下面我们生成相关问题： </think> ### 解决 "Content type 'multipart/form-data;charset=UTF-8' not supported" 错误的方法 该错误通常发生在 Spring Boot 应用中处理文件上传时，主要原因是控制器未能正确解析 multipart/form-data 类型的请求。以下是详细解决方案： #### 1. **检查控制器参数注解** [^3] ```java // 错误用法：@RequestParam 不能直接接收 multipart 请求体 @PostMapping("/upload") public String upload(@RequestParam String file) { ... } // 正确用法：使用 @RequestPart 接收文件 @PostMapping("/upload") public String upload(@RequestPart("file") MultipartFile file) { ... } ``` `@RequestParam` 仅适用于 URL 参数或 `application/x-www-form-urlencoded` 数据，**必须改用 `@RequestPart` 或 `@RequestParam` 配合 `MultipartFile` 类型**接收文件。 #### 2. **验证依赖配置** [^2] 确保 `pom.xml` 包含必要的依赖： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> ``` Spring Boot 2.x+ 已内置 multipart 处理功能，无需额外添加 `commons-fileupload`。 #### 3. **配置 Multipart 属性** (application.properties) ```properties # 启用 multipart 处理 spring.servlet.multipart.enabled=true # 设置最大文件大小（根据需求调整） spring.servlet.multipart.max-file-size=10MB # 设置最大请求大小 spring.servlet.multipart.max-request-size=10MB # 明确指定字符集（可选） spring.servlet.multipart.resolver-charset=UTF-8 ``` #### 4. **检查请求头格式** [^1] 前端请求头需严格符合规范： ```http // 正确的请求头示例 Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryABC123 ``` 确保： - 包含有效的 `boundary` 参数 - 不要手动添加 `charset=UTF-8`（Spring 会自动处理） #### 5. **自定义 MultipartResolver** (可选) 在配置类中添加： ```java @Bean public MultipartResolver multipartResolver() { CommonsMultipartResolver resolver = new CommonsMultipartResolver(); resolver.setDefaultEncoding("UTF-8"); resolver.setMaxUploadSize(10 * 1024 * 1024); // 10MB return resolver; } ``` #### 6. **验证客户端代码** 前端上传示例（使用 Fetch API）： ```javascript const formData = new FormData(); formData.append("file", fileInput.files[0]); // 不要手动设置 Content-Type 头部！ fetch('/upload', { method: 'POST', body: formData // 浏览器会自动生成正确头部 }); ``` > **关键点总结**： > - 使用 `@RequestPart` 或 `MultipartFile` 接收文件 > - 避免手动设置请求头中的 `charset` > - 确保依赖和属性配置正确 > - 客户端让浏览器自动生成 `Content-Type` 头部
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值