使用Apache Camel FTP组件下载文件损坏问题求助

嘿，我之前也踩过类似的Apache Camel FTP下载文件损坏的坑，结合你描述的情况——所有下载的图片都是14.9KB且损坏，运行还没报错，大概率是没正确设置二进制传输模式导致的，咱们一步步来排查解决：

核心问题：ASCII vs 二进制传输模式 #

Apache Camel的FTP组件默认用ASCII传输模式，这种模式会自动转换换行符，对文本文件没问题，但二进制文件（比如图片、视频）一旦走ASCII模式，字节结构被破坏，直接就损坏了。你看到的固定14.9KB，可能是FTP服务器在ASCII模式下返回的错误内容，或是你传递的文件名本身被误当作文件内容下载了。

具体解决方案 #

1. 强制开启二进制传输模式 #

在你的FTP Endpoint URI里加上binary=true参数，明确告诉Camel用二进制模式传输文件。示例：

// 原来的Endpoint可能是这样
.to("ftp://username:password@ftp.example.com/remote-directory")
// 修改后添加binary=true参数
.to("ftp://username:password@ftp.example.com/remote-directory?binary=true")

2. 确认XML读取的文件名是否准确 #

有时候XML解析出的文件名可能带多余空格、换行符或编码错误，导致Camel没匹配到FTP服务器上的正确文件，反而下载了错误内容。可以在路由里加日志打印要下载的文件名，验证准确性：

from("file:./local-xml-dir")
    .unmarshal().jaxb() // 替换成你实际用的XML解析方式
    .log("准备下载的文件名：${body.fileName}") // 替换成你从XML获取文件名的表达式
    .setHeader("CamelFtpFileName", simple("${body.fileName}"))
    .to("ftp://username:password@ftp.example.com/remote-directory?binary=true&fileName=${header.CamelFtpFileName}");

3. 确保路由逻辑是拉取文件而非传递字符串 #

如果你的路由直接把XML读取到的文件名字符串作为body发给FTP组件，可能会让Camel误把这个字符串当作文件内容写入本地，而不是去FTP服务器拉取对应文件名的文件。一定要通过CamelFtpFileName头指定要下载的文件名，或者业务允许的话直接用consumer模式监听FTP目录。

额外排查点 #

• 检查FTP服务器配置：有些服务器会强制要求二进制模式传输非文本文件，否则会拒绝或返回错误内容。
• 验证本地目录写入权限：虽然你能生成文件，但权限不足可能导致文件只写入部分内容（不过你的情况是固定大小，这个可能性较低）。

先试试加binary=true参数，这应该能解决大部分二进制文件损坏的问题，如果还是不行，再通过日志排查文件名和路由逻辑的问题。

内容的提问来源于stack exchange，提问作者juan jose perez hernandez