Android下使用FTP上传PDF文件出现损坏问题

算力阿峰

2026-5-15

排查Android FTPClient上传学校PDF文件损坏的问题

我来帮你梳理一下这个问题的可能原因和解决办法——这种「部分文件正常、部分损坏」的情况，通常和传输配置、文件读取方式或者文件本身的特性有关，结合你的场景，重点排查这几点：

FTP传输模式选错了（ASCII vs 二进制）
这是PDF等二进制文件上传损坏的最常见原因！FTP默认可能会用ASCII模式传输，这种模式会把二进制数据里的特殊字符（比如换行、控制符）自动转换，直接破坏PDF的二进制结构。互联网上的PDF可能刚好兼容性强没出问题，但学校的PDF可能包含更多特殊二进制内容，直接中招。
解决办法：在上传前强制设置二进制传输模式，代码里加上这两行（放在连接服务器成功之后，上传文件之前）：
```
ftpClient.setFileType(FTP.BINARY_FILE_TYPE);
ftpClient.setFileTransferMode(FTP.BINARY_FILE_TYPE);
```
读取PDF时用了字符流而非字节流
如果你在读取本地PDF文件的时候用了Reader这类字符流，而不是InputStream字节流，会把二进制的PDF数据当成字符来解析，必然导致文件损坏。学校的PDF可能包含更多多字节编码的内容，更容易触发这个问题。
解决办法：全程用字节流处理文件，比如：
```
try (FileInputStream fis = new FileInputStream(localPdfFile)) {
    ftpClient.storeFile(remoteFilePath, fis);
} catch (IOException e) {
    // 处理异常
}
```
用try-with-resources能确保流被正确关闭，避免数据丢失。
学校PDF本身的特殊属性（加密/非标准格式）
有些学校的PDF可能加了DRM保护、或者用特殊工具生成了非标准的PDF结构，虽然本地能正常打开，但传输时如果FTP客户端没有完整读取所有字节，就会损坏。
解决办法：先本地复制这个PDF到其他目录，确认复制后的文件能正常打开，排除原文件本身损坏。然后对比本地文件和上传后文件的大小，如果大小不一致，说明传输中途丢了字节——检查AsyncTask里的流有没有提前关闭，或者线程有没有被意外中断。
AsyncTask的线程生命周期问题
如果AsyncTask在上传过程中被系统回收（比如切后台、设备休眠），会导致文件传输中断，出现损坏。如果学校的PDF文件比互联网的更大，这种情况更容易发生。
解决办法：在doInBackground里确保流和FTP连接都被正确关闭，用try-finally或者try-with-resources；如果需要长时间上传，可以考虑用WorkManager替代AsyncTask（AsyncTask在Android 11之后已经被标记为废弃了），或者临时申请WakeLock保持设备唤醒（注意需要WAKE_LOCK权限）。

先从「设置二进制传输模式」和「改用字节流读取」这两点入手排查，这两个是最容易踩的坑，大概率能解决你的问题！

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