Spring Webflux中FilePart transferTo方法首行添加不可见字符问题求助

我之前也碰到过这种诡异的小问题！看起来是Webflux的multipart解析在处理特定编码文件（尤其是带BOM的UTF-8格式）时，transferTo方法写入文件时额外添加了不可见字符，导致Atom这类编辑器无法正确识别TOML的键结构。

下面给你几个可行的解决思路：

1. 手动读取FilePart内容并写入，绕过transferTo #

直接通过FilePart.content()流手动处理数据，完全掌控写入流程，避开框架层可能的编码处理bug：

@PostMapping("/upload")
public Mono<Void> uploadFile(@RequestPart("file") FilePart filePart) {
    Path targetPath = Paths.get("uploads/" + filePart.filename());
    return filePart.content()
            .map(dataBuffer -> {
                // 手动读取DataBuffer内容，避免额外字符注入
                byte[] bytes = new byte[dataBuffer.readableByteCount()];
                dataBuffer.read(bytes);
                DataBufferUtils.release(dataBuffer);
                return bytes;
            })
            .reduce(new ByteArrayOutputStream(), (os, bytes) -> {
                try {
                    os.write(bytes);
                    return os;
                } catch (IOException e) {
                    throw new RuntimeException(e);
                }
            })
            .flatMap(os -> {
                try {
                    Files.write(targetPath, os.toByteArray());
                    return Mono.empty();
                } catch (IOException e) {
                    return Mono.error(e);
                }
            });
}

2. 检查并去除UTF-8 BOM #

如果你的原始文件是UTF-8带BOM的格式，Webflux的解析可能会错误保留BOM并写入文件。可以在写入前手动去除BOM：

private byte[] removeUtf8Bom(byte[] bytes) {
    // 检测UTF-8 BOM标识：EF BB BF
    if (bytes.length >= 3 && bytes[0] == (byte)0xEF && bytes[1] == (byte)0xBB && bytes[2] == (byte)0xBF) {
        return Arrays.copyOfRange(bytes, 3, bytes.length);
    }
    return bytes;
}

在上面的手动写入流程中，把map(dataBuffer -> {...})里的返回值改成removeUtf8Bom(bytes)即可。

3. 升级Spring Boot版本 #

这个问题大概率是特定版本Webflux的已知bug，如果你使用的是2.x早期版本，升级到最新的稳定版（比如2.7.x或3.x系列）可能已经修复了这个问题。尝试更新spring-boot-starter-parent的版本号，重新打包测试即可。

快速验证问题根源 #

你可以用十六进制查看工具确认差异，比如用hexdump命令：

hexdump -C original.toml | head -5
hexdump -C uploaded.toml | head -5

对比输出就能明确看到第一行开头是否多了EF BB BF（UTF-8 BOM）或其他不可见字符。

内容的提问来源于stack exchange，提问作者Bullet-tooth