Spring WebFlux中FilePart的transferTo方法无法写入文件至目标路径求助

核心问题：未处理异步操作 #

FilePart.transferTo(File) 返回的是 Mono<Void>，这是一个异步非阻塞操作，必须被订阅或通过响应式操作符串联到请求流中才会执行。你的代码直接调用 file.transferTo(newFile) 后立即返回 Mono.just(R.ok())，导致文件写入操作根本没被触发就结束了请求。

其他潜在问题 #

• 目标目录不存在：如果 F:/images/banner/ 目录未提前创建，transferTo 会静默失败（未处理异常的情况下）。
• 权限不足：程序可能没有该目录的写入权限，导致文件无法生成。
• 路径/文件名异常：上传的文件名包含特殊字符，或目标路径解析错误。

修复后的代码 #

import org.springframework.http.codec.multipart.FilePart;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Mono;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.File;

@RestController
public class TestController {
    private static final Logger logger = LoggerFactory.getLogger(TestController.class);

    @PostMapping("test")
    public Mono<R> test(FilePart file) {
        String fileName = file.filename();
        File targetDir = new File("F:/images/banner/");
        
        // 确保目标目录存在
        if (!targetDir.exists()) {
            boolean created = targetDir.mkdirs();
            logger.info("目标目录创建结果：{}", created);
        }
        
        File newFile = new File(targetDir, fileName);
        logger.info("待写入文件路径：{}", newFile.getAbsolutePath());

        // 串联异步操作，等待文件写入完成后再返回结果
        return file.transferTo(newFile)
                .then(Mono.just(R.ok())) // 文件写入完成后返回成功
                .onErrorResume(e -> {
                    logger.error("文件上传失败", e);
                    return Mono.just(R.error("上传失败：" + e.getMessage()));
                });
    }
}

额外排查建议 #

1. 手动创建 F:/images/banner/ 目录，排除目录不存在的问题。
2. 查看程序日志，确认目标文件路径是否正确，以及是否有异常抛出。
3. 检查程序运行用户对该目录的写入权限（比如Windows下是否需要管理员权限）。

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