使用Python ftplib传输FTP文件时单个文件无法完整传输的原因

API 探路者

2026-5-21

排查单个FTP文件无法完整传输的问题

这问题我之前帮朋友排查过类似的，咱们一步步拆解可能的原因，逐个验证就能找到根结：

1. 本地文件本身的异常

先校验本地文件的完整性：用哈希工具对比文件原始备份和你要传输的版本，比如Linux/macOS用md5sum [文件名]，Windows用CertUtil -hashfile [文件名] MD5，确保文件没有损坏、被截断或者被其他进程占用。
检查文件是否被锁定：比如传输时杀毒软件正在扫描这个文件，或者编辑器、备份工具还在占用它——这种情况下open虽然能打开，但读取到的内容可能不完整。

确认目标路径[fileURLonServer]的合法性：有没有包含空格、非ASCII字符（比如中文）？部分老旧FTP服务器对特殊字符兼容性差，会导致传输中断。
检查服务器目录权限：这个文件的目标目录是不是和其他文件不一样？比如其他文件传的目录有写入权限，这个目录权限被限制了，导致只能传一部分就被拒绝。
注意文件名大小写：有些FTP服务器是区分大小写的，如果目标路径里的文件名和本地不一致（比如本地是Report.pdf，服务器要传report.pdf），可能和已存在的文件产生冲突，触发截断。

试试添加超时设置：默认ftplib的超时时间可能较短，如果这个文件偏大，传输到一半就触发超时断开了。可以在连接后加一行：
```
ftp.settimeout(300)  # 设置5分钟超时，根据文件大小调整
```
增加传输回调看进度：添加一个回调函数，能实时看到传输的字节数，判断是卡在某个固定点还是随机中断：
```
def track_progress(block):
    print(f"已传输 {len(block)} 字节")

ftp.storbinary(cmd='STOR [fileURLonServer]', fp=myFile, callback=track_progress)
```
如果每次都卡在同一个字节数，大概率是文件本身或服务器端的限制；如果是随机断开，可能是网络波动或超时问题。

手动用FTP客户端（比如FileZilla）传这个文件：如果手动也传不全，那就是服务器的问题——比如服务器对单个文件大小有限制，或者该文件类型被安全策略拦截（比如某些服务器会拦截带特定关键词的日志文件）。
查看服务器日志：如果有权限的话，看看FTP服务器的错误日志，里面会明确记录中断的原因（比如权限不足、文件大小超限）。

确认文件路径是否正确：有没有可能这个文件用了相对路径，而脚本运行的工作目录和其他文件不同，导致打开的是一个空文件或不完整的副本？可以提前用os.path.getsize('[fileURL]')打印本地文件大小，和服务器上传输后的文件大小对比。

内容的提问来源于stack exchange，提问作者Green Cloak Guy