<think>我们正在处理一个非Spring Boot的Spring
Web项目，需要配置`maxFileCount`（即一次请求中允许的最大文件数量）。根据引用[1]中提供的配置示例，我们看到在SpringMVC的配置文件中（如springmvc-servlet
.xml）可以配置`CommonsMultipartResolver`。但是，注意在Tomcat9
.0
.106及之后版本中，对文件上传的数量有了更严格的默认限制（默认10个），所以我们需要调整这个限制。然而，引用[1]中的配置只设置了`maxUploadSize`（总上传大小限制）
和`maxInMemorySize`（内存中最大文件大小），并没有直接设置`maxFileCount`的属性。实际上，`CommonsMultipartResolver`（基于ApacheCommons FileUpload）并没有一个直接的属性叫做`maxFileCount`。但是，我们可以通过设置`maxUploadSizePerFile`
和`maxUploadSize`来间接控制，或者使用另一个解析器。在Spring框架中，除了`CommonsMultipartResolver`，从Spring3
.1开始还提供了`StandardServletMultipartResolver`，但后者需要Servlet3
.0+的支持，并且依赖于Servlet容器提供的multipart解析功能。但是，我们注意到Tomcat9
.0
.106中抛出的异常是`
org.apache
.tomcat
.util
.http
.fileupload
.impl
.FileCountLimitExceededException`，这是Tomcat内部使用的ApacheCommons FileUpload的异常。因此，我们需要在Spring中配置CommonsMultipartResolver时，设置底层的FileUpload对象的相关参数。具体来说，我们可以通过设置`CommonsMultipartResolver`的`fileUpload`属性来配置一个`CommonsFileUploadSupport`，然后设置其`FileUpload`对象，而`FileUpload`对象可以设置`FileSizeMax`
和`SizeMax`，以及一个重要的参数：`FileCountMax`。因此，在非
SpringBoot的Spring
Web项目中，我们可以这样配置：步骤：1
.在SpringMVC的配置文件中（如springmvc-servlet
.xml），配置一个`CommonsMultipartResolver` bean。2
.设置`defaultEncoding`等属性。3
.创建一个`DiskFileItemFactory`（可选，用于设置临时目录等）。4
.创建一个`ServletFileUpload`对象，并设置其`FileCountMax`（这就是最大文件数量）。5
.将`ServletFileUpload`对象设置给`CommonsMultipartResolver`的`fileUpload`属性。但是，注意`CommonsMultipartResolver`并没有直接暴露`setFileCountMax`方法，我们需要通过自定义`fileUpload`的方式。实际上，我们可以这样做：首先，配置`CommonsMultipartResolver`，然后通过设置其`fileUpload`属性为一个已经配置好的`ServletFileUpload`实例。示例配置如下：
```xml<beanid="multipartResolver"class="
org.springframework
.web.multipart
.commons
.CommonsMultipartResolver"><property name="defaultEncoding"value="UTF-8"/><!--设置最大上传总大小（单位：字节）--><propertyname="maxUploadSize"value="102400000"/><!--设置最大内存大小（单位：字节）--><propertyname="maxInMemorySize" value="4096"/><!--设置临时目录（可选） --><property name="uploadTempDir" value="file:/tmp/upload"/><!--通过fileUpload属性设置ServletFileUpload--><propertyname="fileUpload"><beanclass="
org.apache
.commons
.fileupload
.servlet
.ServletFileUpload"><constructor-arg><bean class="
org.apache
.commons
.fileupload
.disk
.DiskFileItemFactory"><!--设置临时目录（这里可以具体配置） --><property name="repository" value="file:/tmp/upload"/></bean></constructor-arg><!--设置文件数量限制 --><property name="fileCountMax" value="50"/><!--也可以设置单个文件的最大大小
和总请求的最大大小 --><property name="fileSizeMax" value="10485760"/> <!--10MB --><property name="sizeMax"value="104857600"/><!--100MB--></bean></property>
</bean>```注意：上面的配置中，我们通过`fileUpload`属性设置了一个`ServletFileUpload`实例，并在其中设置了`fileCountMax`为50（即一次请求最多50个文件）。同时，我们也可以设置单个文件大小（`fileSizeMax`）
和整个请求的大小（`sizeMax`）。这里设置的`sizeMax`应该
和`CommonsMultipartResolver`的`maxUploadSize`一致，建议只设置一处，避免混淆。另外，`CommonsMultipartResolver`本身也有`setMaxUploadSize`方法，它会覆盖`ServletFileUpload`的`sizeMax`设置。因此，为了清晰，我们可以只设置`CommonsMultipartResolver`的`maxUploadSize`，然后在`fileUpload`中设置`fileCountMax`
和`fileSizeMax`。但是，实际上`CommonsMultipartResolver`在初始化时会根据我们设置的`fileUpload`来创建自己的`FileUpload`实例，并且会用自己的`maxUploadSize`等去覆盖。因此，为了避免混淆，我们可以这样：方法1：只通过`CommonsMultipartResolver`设置总大小
和内存大小，然后通过`fileUpload`属性设置`fileCountMax`
和`fileSizeMax`（单个文件最大大小）。这样，`CommonsMultipartResolver`在初始化时会使用我们提供的`fileUpload`，并设置其`sizeMax`为`maxUploadSize`（如果设置了的话）。所以，我们可以在`fileUpload`中设置`fileCountMax`，而`sizeMax`由`CommonsMultipartResolver`的`maxUploadSize`决定。方法2：不设置`CommonsMultipartResolver`的`maxUploadSize`，而在`fileUpload`中设置`sizeMax`。为了确保正确，我们可以采用方法1，即：```xml<beanid="multipartResolver"class="
org.springframework
.web.multipart
.commons
.CommonsMultipartResolver"><propertyname="defaultEncoding" value="UTF-8"/><!--总上传大小限制（整个请求）--><propertyname="maxUploadSize"value="104857600"/><!--100MB--><property name="maxInMemorySize"value="4096"/><property name="fileUpload"><bean class="
org.apache
.commons
.fileupload
.servlet
.ServletFileUpload"><constructor-arg><beanclass="
org.apache
.commons
.fileupload
.disk
.DiskFileItemFactory"><property name="repository"><bean class="java
.io
.File"><constructor-argvalue="/tmp/upload"/></bean></property></bean></constructor-arg><!--设置最大文件数量 --><property name="fileCountMax" value="50"/><!--设置单个文件最大大小（10MB） --><property name="fileSizeMax" value="10485760"/></bean></property>
</bean>```这样，我们配置了：-整个请求最大100MB（通过`maxUploadSize`）-单个文件最大10MB（通过`fileUpload`的`fileSizeMax`）-一次请求最多50个文件（通过`fileUpload`的`fileCountMax`）注意：`DiskFileItemFactory`的`repository`属性是设置临时目录，这里我们设置为`/tmp/upload`，确保该目录存在且有写权限。另外，如果不想设置临时目录，也可以不配置`DiskFileItemFactory`，使用默认的临时目录（但要注意Tomcat9
.0
.106会清理临时目录的
问题，所以最好设置一个固定的临时目录，并确保应用有权限）。这样配置后，当上传的文件数量超过50个时，就会抛出`FileCountLimitExceededException`，然后我们可以通过异常处理机制捕获并返回友好信息（类似引用[2]中处理`MaxUploadSizeExceededException`的方式）。总结：在非
SpringBoot的Spring
Web项目中，通过配置`CommonsMultipartResolver`的`fileUpload`属性，设置`ServletFileUpload`的`fileCountMax`，即可调整一次请求允许的最大文件数量。注意：以上配置适用于使用ApacheCommons FileUpload的情况，并且需要确保
项目中已经包含了commons-fileupload依赖。依赖示例（Maven）：
```xml<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1
.4</version> <!--建议使用1
.3+版本-->
</dependency>```如果使用Gradle：```groovyimplementation'commons-fileupload:commons-fileupload:1
.4'
```最后，请根据实际需求调整上述配置中的数值（如文件数量、大小等）。希望这个配置能
解决Tomcat9
.0
.106及更高版本中出现的`FileCountLimitExceededException`
问题。§§相关
问题§§1
.如何在Spring Boot
项目中配置maxFileCount？
2
.如何统一处理文件上传数量超限的异常？3
.如何设置文件上传的临时目录以避免Tomcat自动清理？</think>### 在非 Spring Boot 的 Spring
Web 项目中配置 maxFileCount
在非 Spring Boot 的 Spring
Web 项目中（如传统 Spring MVC
项目），您需要通过 XML 配置来设置 `maxFileCount`（单次请求允许的最大文件数量）。以下是详细配置步骤：
---
#### 配置方法（基于 Apache Commons FileUpload）
在您的 Spring MVC 配置文件（如 `springmvc-servlet
.xml`）中添加以下配置：
```xml
<bean id="multipartResolver"
class="
org.springframework
.web.multipart
.commons
.CommonsMultipartResolver">
<!-- 设置最大文件数量 (关键配置) -->
<property name="maxUploadSizePerFile" value="10485760" /> <!-- 单个文件最大10MB -->
<property name="maxUploadSize" value="104857600" /> <!-- 总请求最大100MB -->
<property name="fileCountMax" value="50" /> <!-- 最大文件数量 -->
<property name="defaultEncoding" value="UTF-8" />
<property name="maxInMemorySize" value="4096" /> <!-- 内存缓冲区大小 -->
</bean>
```
#### 关键参数说明：
1
. **`fileCountMax`**
- 控制单次请求允许上传的最大文件数量
- 例如 `value="50"` 表示最多允许50个文件
2
. **`maxUploadSizePerFile`**
- 单个文件的最大尺寸（单位：字节）
- 示例：`10485760` = 10 MB
3
. **`maxUploadSize`**
- 整个 HTTP 请求的最大尺寸（包含所有文件+表单数据）
- 示例：`104857600` = 100 MB
---
#### 依赖要求
确保
项目中包含 Apache Commons FileUpload 依赖：
```xml
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1
.4</version> <!-- 推荐1
.3
.3+ -->
</dependency>
```
---
#### 注意事项
1
. **与 Tomcat 版本的兼容性**
在 Tomcat 9
.0
.106+ 中，默认文件数量限制较低（通常为10个）。通过此配置可覆盖默认值[^1]。
2
. **异常处理**
当超出限制时，Spring 会抛出 `MultipartException`，您可以通过 `@ExceptionHandler` 捕获：
```java
@ControllerAdvice
public class FileUploadExceptionHandler {
@ExceptionHandler(MultipartException
.class)
public ResponseEntity<String> handleUploadError(MultipartException ex) {
return ResponseEntity
.status(413)
.body("上传失败: " + ex
.getCause()
.getMessage());
}
}
```
3
. **临时目录
问题**
为防止 Tomcat 自动清理临时文件，可显式设置目录：
```xml
<bean id="multipartResolver"
...>
<property name="uploadTempDir" value="file:/data/upload_tmp"/>
</bean>
```
---
#### 配置生效验证
1
. 创建测试控制器：
```java
@PostMapping("/test-upload")
public String testUpload(@RequestParam("files") MultipartFile[] files) {
return "成功接收文件数: " + files
.length;
}
```
2
. 使用 Postman 发送多文件请求：
- 添加多个 `files` 类型的表单字段
- 观察是否在超过 `fileCountMax` 时返回错误
---
### 配置差异说明
| 配置方式 | Spring Boot (application
.properties) | 传统 Spring (XML) |
|-------------------|-------------------------------------------|-------------------------------------------|
| **文件数量限制** | `spring
.servlet
.multipart
.max-files-per-request=50` | `<property name="fileCountMax" value="50"/>` |
| **单个文件大小** | `spring
.servlet
.multipart
.max-file-size=10MB` | `<property name="maxUploadSizePerFile" value="10485760"/>` |
| **总请求大小** | `spring
.servlet
.multipart
.max-request-size=100MB` | `<property name="maxUploadSize" value="104857600"/>` |
[^1]: 此配置通过覆盖 Tomcat 默认限制
解决 FileCountLimitExceededException
[^2]: 异常处理策略参考 Spring 官方文档
本文提供了SpringBoot与多种技术的整合教程，包括MongoDB、Redis、RabbitMQ、JPA及事件监听器的详细配置和使用方法，同时解决了前端Ajax POST请求参数异常的问题。
扫一扫
1611
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
