Spring Boot 使用 ServletFileUpload上传文件失败,upload.parseRequest(request)为空

在SpringBoot应用中遇到使用Apache Commons FileUpload上传文件返回null的问题,原因是SpringBoot有默认的MultipartResolver。解决方法是在yml配置中设置`spring.servlet.multipart.enabled=false`来禁用默认配置。然后通过DiskFileItemFactory和ServletFileUpload解析请求,读取并保存上传的文件。注意检查表单是否设置了`enctype=multipart/form-data`。如果表单不是这种类型,需要处理非文件字段。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

问题原因

使用Apache Commons FileUpload组件上传文件时总是返回null,调试发现ServletFileUpload对象为空,在Spring Boot中有默认的文件上传组件,在使用ServletFileUpload时需要关闭Spring Boot的默认配置 ,禁用MultipartResolverSpring提供的默认值

解决办法:
在yml配置文件中添加 spring.servlet.multipart.enabled=false

注:
将表单中的数据变成二进制数据(enctype=“multipart/form-data”)进行上传,这时候如果用request是无法直接获取到相应表单的值的

解决办法:

public void execute1(HttpServletRequest request) throws IOException {
        try {
            //获取文件保存路径,判断是否存在该目录如果不存在创建
            String Path = "/test.txt";
            File file = new File(Path);
            //判断文件是否存在,不存在就创建
            if (!file.exists() && !file.isDirectory()) {
                file.mkdirs();
            }
            DiskFileItemFactory factroy = new DiskFileItemFactory();
            //创建文件上传解析器
            ServletFileUpload upload = new ServletFileUpload(factroy);
            //判断前端form表单是否为enctype="multipart/form-data"属性
            boolean isF = ServletFileUpload.isMultipartContent(request);
            //如果前端传过来的是表单是enctype="multipart/form-data"属性
            if (isF) {
                //使用解析器解析上传的表单数据,每个FileItem对应一个表单项
                List<FileItem> fileItemList = upload.parseRequest(request);
                for (FileItem fileItem : fileItemList) {
                    if (!fileItem.isFormField()) {
                        //不是普通的表单项,即是上传的是文件
                        //获取文件名称
                        String fileName = fileItem.getName();
                        if (fileName.isEmpty()) {
                            //如果文件名为空
                            return;
                        }
                        //获取上传文件输入流
                        InputStream in = fileItem.getInputStream();
                        //创建文件输出流
                        Path += "\\" + fileName;
                        String str = "";
                        String leng = "";
                        BufferedReader br = new BufferedReader(new InputStreamReader(in, "utf-8"));
                        while ((leng = br.readLine()) != null) {
                            str += leng;
                        }
                        System.out.println(str);
                        BufferedWriter bw = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(new File(Path))));
                        bw.write(str);
                        bw.flush();
                        bw.close();
                        br.close();
                        //FileItem对象被垃圾收集器收集时会自动清除临时文件,但及时调用delete方法可以更早的清除临时文件,释放系统存储资源。
                        // 另外,当系统出现异常时,仍有可能造成有的临时文件被永久保存在了硬盘中。
                        fileItem.delete();
                    } else {
                       /**
                         * 获取表单中的非文件值
                         */
                        //表单中的空间name值
                        System.out.println(fileItem.getFieldName());
                        //该name值空间中的value值
                        System.out.println(fileItem.getString("UTF-8"));
                    }
                }
            } else {
                //判断前端form表单不是enctype="multipart/form-data"属性,这里就不做处理了
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
<think>好的,我现在要解决用户关于ServletFileUpload.parseRequest(request)报错的问题。用户之前已经提过这个问题,现在又补充了一些站内引用,我需要结合这些引用和之前的回答来给出更准确的解决方案。 首先,用户这次的引用提到几个关键点:本地环境正常但Linux服务器报错,解析请求后再次解析为,以及在Spring Boot使用时的问题。这可能涉及环境差异、多次解析请求、配置问题等。 回顾之前的回答,我提到了参数类型不匹配和错误使用底层类的问题,并建议使用ServletFileUpload来替代FileUploadBase。现在需要整合新的引用内容,特别是引用2提到的多次解析导致数据的问题,以及引用3中在Spring Boot中的处理方式。 用户现在想知道错误的具体原因和解决方案。需要分析可能的错误原因,比如多次解析、配置不一致、环境差异、依赖版本问题等。结合引用2,多次解析会导致请求流被消费,无法再次读取,这点很重要。引用3提到在Spring Boot中可能需要使用ServletRequestContext,这可能是因为框架处理请求的方式不同。 接下来要组织回答结构,分点说明原因和对应的解决方案。需要确保涵盖所有引用中提到的问题,比如环境配置、多次解析、依赖冲突、Spring Boot的特殊处理等。同时,要提供具体的代码示例和配置建议,比如检查依赖版本、配置参数、避免多次解析等。 还要注意用户可能是在不同环境下遇到问题,比如本地和服务器环境差异,需要检查依赖版本是否一致,配置文件是否正确。此外,在Spring MVC或Spring Boot中,可能有框架自身的处理机制,导致需要调整解析方式,比如使用CommonsMultipartResolver或避免多次解析。 最后,生成相关问题时要覆盖用户可能遇到的其他问题,比如配置参数、大小限制、依赖冲突排查等。确保回答清晰,结构合理,帮助用户全面理解问题并解决。</think>#### 深度解析:`ServletFileUpload.parseRequest(request)`错误原因及解决方案 --- ### 一、核心错误原因分析 结合引用内容和实际开发场景,`parseRequest`报错主要涉及以下4类根本原因: 1. **请求流重复消费 (关键原因)** - **引用[2]明确说明**:HttpServletRequest的输入流只能被读取一次,若框架层(如SpringMVC)或开发者代码已调用过`parseRequest`,二次解析必然失败[^2] - **典型场景**:同时使用原生ServletFileUploadSpring的`@RequestParam`接收文件 2. **环境配置差异** - **引用[1]中的现象**:本地正常但服务器异常,常见于: - 服务器缺少`commons-fileupload`依赖或版本不一致 - 服务器未正确配置临时目录写入权限 $$ \text{Linux权限问题示例}:chmod -R 777 /tmp/upload\_cache $$ 3. **请求未正确封装** - **引用[3]的解决方案**:在Spring Boot等现代框架中,需使用`ServletRequestContext`封装请求对象 ```java // Spring Boot特殊处理 List<FileItem> items = upload.parseRequest(new ServletRequestContext(request)); ``` 4. **配置参数缺失** ```java // 必须设置内存缓冲区与临时目录 DiskFileItemFactory factory = new DiskFileItemFactory(); factory.setSizeThreshold(1024*1024); // 1MB内存缓冲 factory.setRepository(new File("/tmp/uploads")); ``` --- ### 二、分步解决方案 #### 步骤1:确认请求仅解析一次 | 错误模式 | 修正方案 | |---------|----------| | ```java // Controller中混合使用 List<FileItem> items = upload.parseRequest(request); @RequestParam("file") MultipartFile file // 冲突! ``` | **方案一**:完全使用ServletFileUpload解析 **方案二**:完全使用Spring的MultipartFile接收 | #### 步骤2:环境一致性检查 ```bash # Linux服务器验证步骤 ls -l $TOMCAT_HOME/lib/commons-fileupload-*.jar # 检查jar存在性 df -h /tmp # 检查磁盘间 ulimit -a | grep openfiles # 检查文件句柄限制 ``` #### 步骤3:完整配置示例(Spring Boot) ```java @Bean public MultipartConfigElement multipartConfigElement() { DiskFileItemFactory factory = new DiskFileItemFactory(); factory.setSizeThreshold(1024*1024); factory.setRepository(Paths.get("/tmp").toFile()); ServletFileUpload upload = new ServletFileUpload(factory); upload.setFileSizeMax(1024*1024*50); // 50MB单文件限制 upload.setSizeMax(1024*1024*100); // 100MB总请求限制 return new MultipartConfigElement(""); } ``` --- ### 三、高级调试技巧 1. **请求头验证** 使用抓包工具检查`Content-Type`是否包含`multipart/form-data` ```http POST /upload HTTP/1.1 Content-Type: multipipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW ``` 2. **依赖树分析** Maven执行`mvn dependency:tree`检查是否存在多个版本的fileupload库 ```xml <!-- 正确依赖声明 --> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.5</version> </dependency> ``` 3. **异常类型对照表** | 异常信息 | 解决方案 | |---------|----------| | `FileUploadException: Stream closed` | 禁止重复读取request | | `FileSizeLimitExceededException` | 调整setFileSizeMax() | | `IOExceptions` | 检查服务器磁盘间 | --- ### 四、框架整合建议 对于**SpringMVC/SpringBoot**用户,推荐优先使用`CommonsMultipartResolver`: ```java @Bean(name = "multipartResolver") public CommonsMultipartResolver multipartResolver() { CommonsMultipartResolver resolver = new CommonsMultipartResolver(); resolver.setDefaultEncoding("UTF-8"); resolver.setMaxUploadSize(52428800); // 50MB return resolver; } ``` 通过`@RequestParam MultipartFile file`接收文件,避免手动解析request[^3] ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值