<think>我们正在讨论一个关于JavaWeb开发中
文件上传的
问题。具体
问题是：使用
ServletFileUpload的parse
Request方法
获取不到上传文件。这个
问题可能由多种原因引起，我们需要逐步排查。可能的原因及解决方案：1.表单
没有设置enctype="multipart/form-data"。如果表单使用
文件上传，必须设置enctype属性为"multipart/form-data"，否则服务器无法解析
文件部分。2.
没有正确创建
ServletFileUpload对象。需要确保使用DiskFileItemFactory创建
ServletFileUpload对象。3.请求不是HttpServlet
Request类型。parse
Request方法需要传入HttpServlet
Request对象。4.
文件大小超过限制，导致解析失败。可以检查是否有异常抛出。5.
没有正确
获取文件项。下面是一个标准的
文件上传处理示例：步骤：1.检查请求是否为multipart类型（即enctype="multipart/form-data"）。2.创建DiskFileItemFactory和
ServletFileUpload对象。3.解析请求，得到FileItem列表。4.遍历每个FileItem，判断是普通字段还是
文件字段。注意：在Servlet3.0之后，还可以使用@MultipartConfig注解来实现
文件上传，但这里的
问题是关于commons-fileupload的使用。代码示例（使用ApacheCommonsFileUpload）：首先，确保已经将commons-fileupload和commons-io的jar包添加到项目中。假设前端表单如下：```html<formaction="/upload"method="post"enctype="multipart/form-data"><inputtype="file"name="file"/><inputtype="submit"/></form>```后端Servlet处理代码：```javaimportorg.apache.commons.fileupload.FileItem;importorg.apache.commons.fileupload.FileUploadException;importorg.apache.commons.fileupload.disk.DiskFileItemFactory;importorg.apache.commons.fileupload.servlet.
ServletFileUpload;importjavax.servlet.http.HttpServlet;importjavax.servlet.http.HttpServlet
Request;importjavax.servlet.http.HttpServletResponse;importjava.io.File;importjava.io.IOException;importjava.util.List;publicclassUploadServletextendsHttpServlet{protectedvoiddoPost
(HttpServlet
Requestrequest,HttpServletResponseresponse
)throwsIOException{//检查请求是否包含multipart内容if
(!
ServletFileUpload.isMultipartContent
(request)){response.getWriter
().println
("Error:Formmusthaveenctype=multipart/form-data."
);response.setStatus
(HttpServletResponse.SC_BAD_
REQUEST);return;}//配置
上传参数DiskFileItemFactoryfactory=newDiskFileItemFactory
();//设置内存存储临界值-超过后将产生临时
文件并存储于临时目录中factory.setSizeThreshold
(1024*1024*3
);//3MB//设置临时存储目录factory.setRepository
(newFile
(System.getProperty
("java.io.tmpdir"
)));
ServletFileUploadupload=new
ServletFileUpload(factory
);//设置单个
文件的最大
上传值upload.setFileSizeMax
(1024*1024*40
);//40MB//设置整个请求的最大
上传值upload.setSizeMax
(1024*1024*50
);//50MB//构造
上传路径（确保目录存在）StringuploadPath=getServletContext
().getRealPath
(""
)+File.separator+"uploads";FileuploadDir=newFile
(uploadPath
);if
(!uploadDir.exists
()){uploadDir.mmkdirs
();}try{//解析请求，
获取文件项列表List<FileItem>formItems=upload.parse
Request(request);if
(formItems==null||formItems.isEmpty
()){response.getWriter
().println
("Nofileuploaded!"
);return;}//遍历表单项for
(FileItemitem:formItems
){//处理普通表单字段（非
文件）if
(item.isFormField
()){StringfieldName=item.getFieldName
();Stringvalue=item.getString
("UTF-8"
);System.out.println
("Field:"+fieldName+",Value:"+value
);}else{//处理
文件字段StringfileName=newFile
(item.getName
()).getName
();StringfilePath=uploadPath+File.separator+fileName;FilestoreFile=newFile
(filePath
);//保存
文件到磁盘item.write
(storeFile
);response.getWriter
().println
("File"+fileName+"uploadedsuccessfully."
);}}}catch
(FileUploadExceptione
){e.printStackTrace
();response.getWriter
().println
("Fileuploadfailed:"+e.getMessage
());}catch
(Exceptione
){e.printStackTrace
();response.getWriter
().println
("Error:"+e.getMessage
());}}}```解释：1.首先，我们使用`
ServletFileUpload.isMultipartContent
(request)`检查请求是否为multipart类型。2.创建`DiskFileItemFactory`对象，并设置内存阈值和临时存储目录。3.创建`
ServletFileUpload`对象，并设置
文件大小和请求总大小的限制。4.指定
上传文件的存储目录，并确保该目录存在。5.使用`upload.parse
Request(request)`解析请求，得到一个`List<FileItem>`。6.遍历每个`FileItem`，如果是普通字段，则
获取字段名和值；如果是
文件字段，则将
文件保存到指定路径。常见
问题排查：-确保表单的enctype属性设置正确。-确保在Servlet中
获取的是POST请求。-检查是否有异常抛出，例如
文件大小超过限制会抛出`FileUploadBase.SizeLimitExceededException`。-确保`commons-fileupload`和`commons-io`的版本兼容，并且已经正确添加到项目的类路径中。如果按照以上步骤仍然无法
获取到
上传的
文件，请检查：-请求是否被其他过滤器或拦截器处理，导致请求内容被读取过（因为HttpServlet
Request的输入
流只能读取一次）。如果存在这样的过滤器，可以考虑使用`HttpServlet
Request`的装饰器来包装请求，以便重复读取输入
流。但是，对于
文件上传，通常需要避免在
文件上传之前读取请求体。相关
问题：§§相关
问题§§:1.在Servlet3.0中如何使用@MultipartConfig注解实现
文件上传？2.如何限制
上传文件的类型？3.当
上传文件超过大小时，如何捕获异常并给出友好提示？4.如何实现多
文件上传？</think>### 解决
ServletFileUpload.parse
Request 获取不到上传文件的
问题
#### 常见原因及解决方案：
1. **表单未设置 `enctype="multipart/form-data"`**
- 必须设置表单的编码类型，否则服务器无法识别
文件数据
- 前端代码示例：
```html
<!-- 错误示例 -->
<form action="/upload" method="post">
<input type="file" name="file">
</form>
<!-- 正确示例 -->
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="file">
</form>
```
2. **缺少 Apache Commons FileUpload 依赖**
- 检查 `pom.xml` 是否包含以下依赖：
```xml
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.5</version> <!-- 使用最新版本 -->
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.15.1</version> <!-- 使用最新版本 -->
</dependency>
```
3. **未正确初始化 DiskFileItemFactory**
- 必须创建工厂实例和解析器：
```java
// 错误：直接使用 new
ServletFileUpload()
// 正确：通过 DiskFileItemFactory 初始化
DiskFileItemFactory factory = new DiskFileItemFactory
();
ServletFileUpload upload = new
ServletFileUpload(factory
);
```
4. **请求内容已被提前读取**
- 过滤器或其他代码提前读取了 `HttpServlet
Request` 的输入
流
- 解决方案：在过滤器中跳过对
文件上传请求的处理
#### 完整解决方案代码：
```java
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.
ServletFileUpload;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServlet
Request;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.util.List;
public class FileUploadServlet extends HttpServlet {
protected void doPost
(HttpServlet
Request request, HttpServletResponse response
) {
// 1. 检查是否为
文件上传请求
if
(!
ServletFileUpload.isMultipartContent
(request)) {
response.setStatus
(HttpServletResponse.SC_BAD_
REQUEST);
response.getWriter
().print
("Error: Form must have enctype=multipart/form-data"
);
return;
}
// 2. 配置存储参数
DiskFileItemFactory factory = new DiskFileItemFactory
();
factory.setSizeThreshold
(1024 * 1024
); // 1MB内存缓冲区
factory.setRepository
(new File
(System.getProperty
("java.io.tmpdir"
))); // 临时目录
// 3. 创建
文件上传处理器
ServletFileUpload upload = new
ServletFileUpload(factory
);
upload.setFileSizeMax
(1024 * 1024 * 10
); // 10MB单
文件限制
upload.setSizeMax
(1024 * 1024 * 50
); // 50MB总请求限制
try {
// 4. 解析请求
获取文件项
List<FileItem> items = upload.parse
Request(request);
if
(items == null || items.isEmpty
()) {
response.getWriter
().print
("No files uploaded"
);
return;
}
// 5. 处理每个
文件项
for
(FileItem item : items
) {
if
(!item.isFormField
()) { //
文件字段
String fileName = new File
(item.getName
()).getName
();
File storeFile = new File
("/upload/path/" + fileName
);
item.write
(storeFile
); // 保存
文件
response.getWriter
().print
("Uploaded: " + fileName
);
} else { // 普通表单字段
String fieldName = item.getFieldName
();
String value = item.getString
();
// 处理文本参数...
}
}
} catch
(FileUploadException e
) {
response.setStatus
(500
);
response.getWriter
().print
("Upload error: " + e.getMessage
());
} catch
(Exception e
) {
response.setStatus
(500
);
response.getWriter
().print
("Server error: " + e.getMessage
());
}
}
}
```
#### 关键点解释：
1. **`isMultipartContent
()` 检查**
验证请求是否包含 `multipart/form-data` 内容类型，避免无效解析。
2. **DiskFileItemFactory 配置**
- `setSizeThreshold
()`：设置内存缓冲区大小（超过则使用临时
文件）
- `setRepository
()`：指定临时
文件存储目录
3. **
文件大小限制**
- `setFileSizeMax
()`：单个
文件最大尺寸
- `setSizeMax
()`：整个请求的最大尺寸
4. **
文件项处理**
- `item.isFormField
()` 区分
文件字段和普通表单字段
- `item.write
()` 将
文件保存到永久存储
#### 常见错误排查：
1. 使用 `
request.getParameter
()` 会清
空输入
流，导致 `parse
Request()`
获取空列表
2.
文件路径权限
问题：确保服务器对目标目录有
写权限
3. 前端框架（如 Axios）需正确配置 `Content-Type: multipart/form-data`
---
###
扫一扫
2487
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
