Wildfly部署时MultipartFile.transferTo()报文件已存在异常求助

问题背景 #

部署在Wildfly 16上的Spring应用，调用MultipartFile.transferTo(File)转存上传的zip文件时抛出以下异常：

File element in parameter 'null' already exists: 'E:\JBoss\wildfly-16.0.0_9090_9191\standalone\deployments\MyWar.war\My_Export.zip'
at org.apache.commons.io.FileUtils.requireAbsent(FileUtils.java:2587)
at deployment.MyWar.war//org.apache.commons.io.FileUtils.moveFile(FileUtils.java:2305)
at deployment.MyWar.war//org.apache.commons.io.FileUtils.moveFile(FileUtils.java:2283)
at deployment.MyWar.war//org.apache.commons.fileupload.disk.DiskFileItem.write(DiskFileItem.java:405)
at deployment.MyWar.war//org.springframework.web.multipart.commons.CommonsMultipartFile.transferTo(CommonsMultipartFile.java:168)

手动调用file.delete()返回true，但file.exists()仍返回true，相同代码在Tomcat 8.5上可正常运行，使用依赖版本：spring-web:5.3.23、commons-io:2.11、commons-fileupload:1.4。

问题原因 #

1. Wildfly对**部署目录（standalone/deployments/MyWar.war/）**有文件锁定和缓存机制，手动删除文件后，容器的文件系统视图未即时更新，导致exists()返回true。
2. CommonsMultipartFile依赖的commons-fileupload在Wildfly环境下，文件移动逻辑会严格检查目标文件是否存在，而Tomcat环境下允许覆盖，两者容器行为差异导致异常。

解决方案 #

1. 转存到容器外独立目录 #

避免使用Wildfly的部署目录，直接将文件存到容器外的独立文件夹，彻底绕过容器的文件管理限制：

// 示例：存到容器外的上传目录
File targetFile = new File("E:\\wildfly_uploads\\My_Export.zip");
multipartFile.transferTo(targetFile);

2. 用NIO API强制清理目标文件 #

如果必须使用部署目录，改用Java NIO的Files.deleteIfExists()替代File.delete()，该API能更可靠地绕过容器缓存，确保文件被彻底删除：

File targetFile = new File("E:\\JBoss\\wildfly-16.0.0_9090_9191\\standalone\\deployments\\MyWar.war\\My_Export.zip");
// 用NIO API确保文件被删除
Files.deleteIfExists(targetFile.toPath());
// 执行转存
multipartFile.transferTo(targetFile);

3. 切换到Spring标准文件上传实现 #

排除commons-fileupload依赖，让Spring使用Servlet 3.0原生的StandardMultipartFile，避免commons-fileupload与Wildfly的逻辑冲突：

• Maven依赖修改（排除commons-fileupload）：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>5.3.23</version>
    <exclusions>
        <exclusion>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• 添加Spring配置启用Servlet原生文件上传：

@Configuration
public class MultipartConfig {
    @Bean
    public MultipartResolver multipartResolver() {
        return new StandardServletMultipartResolver();
    }
}

内容的提问来源于stack exchange，提问作者SuhasD