"Failed to parse multipart servlet request; nested exception is org.apache.tomcat.util.http.fileupload.impl.FileCountLimitExceededException: attachment"

### Tomcat中因文件数量限制导致的multipart请求解析失败问题解决方案 在处理 `org.springframework.web.multipart.MultipartException` 异常时，通常是因为Tomcat临时目录无法正确解析multipart请求[^1]。这种异常可能由多种原因引起，例如临时目录权限不足、磁盘空间不足或文件数量超出限制等。 #### 1. 调整Tomcat的临时目录配置 默认情况下，Tomcat使用系统临时目录（如 `/tmp`）来存储上传文件的临时数据。如果临时目录中的文件数量过多或磁盘空间不足，可能会导致解析失败。可以通过以下方式调整临时目录配置： - **修改`server.xml`文件**：在Tomcat的`<Host>`标签中添加或修改`workDir`属性，指定一个新的工作目录。 ```xml <Host name="localhost" appBase="webapps" workDir="/path/to/custom/workdir"> ``` - **设置环境变量**：通过设置`JAVA_OPTS`或`CATALINA_OPTS`环境变量，指定新的临时目录。 ```bash export JAVA_OPTS="-Djava.io.tmpdir=/path/to/new/tmp" ``` #### 2. 增加文件描述符限制 操作系统对每个进程可打开的文件描述符数量有限制，当上传大量文件时，可能会超出此限制。可以通过以下方法增加文件描述符限制： - **查看当前限制**： ```bash ulimit -n ``` - **永久修改限制**：编辑`/etc/security/limits.conf`文件，添加以下内容： ``` * soft nofile 65535 * hard nofile 65535 ``` - **重启Tomcat服务**以应用更改。 #### 3. 配置Spring的Multipart解析器 Spring提供了`CommonsMultipartResolver`和`StandardServletMultipartResolver`两种解析器。可以通过配置解析器参数来优化文件上传性能。 - **示例配置**： ```properties spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=50MB spring.servlet.multipart.file-size-threshold=2KB ``` - **自定义解析器**： 如果需要更复杂的配置，可以手动定义解析器： ```java @Bean(name = "multipartResolver") public CommonsMultipartResolver multipartResolver() { CommonsMultipartResolver resolver = new CommonsMultipartResolver(); resolver.setMaxUploadSize(52428800); // 50MB resolver.setMaxInMemorySize(2097152); // 2MB return resolver; } ``` #### 4. 清理临时文件 如果临时目录中存在大量未清理的文件，可能导致文件数量限制被触发。可以通过以下方式清理临时文件： - **定时任务**：创建一个定时任务，定期删除临时目录中的旧文件。 ```bash find /path/to/tmp -type f -mtime +1 -exec rm -f {} \; ``` - **应用层处理**：在代码中确保上传完成后及时删除临时文件。 ```java File tempFile = multipartFile.getFileItem().getTempFile(); if (tempFile.exists()) { tempFile.delete(); } ``` #### 5. 使用外部存储 对于大规模文件上传场景，建议将文件存储到外部存储系统（如Amazon S3、阿里云OSS），避免依赖本地临时目录。 ```java // 示例：使用AWS SDK上传文件到S3 public void uploadToS3(MultipartFile file) { try { AmazonS3 s3Client = AmazonS3ClientBuilder.defaultClient(); ObjectMetadata metadata = new ObjectMetadata(); metadata.setContentLength(file.getSize()); s3Client.putObject(new PutObjectRequest("bucket-name", "file-key", file.getInputStream(), metadata)); } catch (IOException e) { throw new RuntimeException("Failed to upload file to S3", e); } } ``` --- ### 总结 上述方法从多个角度解决了Tomcat中因文件数量限制导致的multipart请求解析失败问题。包括调整临时目录配置、增加文件描述符限制、优化Spring解析器配置、清理临时文件以及使用外部存储等方式。