如何用Python脚本登录FTP并下载XML文件？

在自动化数据处理场景中，经常需要把远端服务器上的XML文件定时拉取到本地进行解析。Python标准库中的ftplib模块提供了完整的FTP客户端能力，无需安装第三方依赖即可完成登录、切换目录和下载文件等操作。理解FTP的连接机制以及二进制传输方式，是写出稳定下载脚本的基础。

一、FTP协议与Python客户端基础

FTP（文件传输协议）采用分离的控制连接与数据连接设计。控制连接通常建立在21端口，用于发送命令和接收响应；数据连接则根据实际传输需求动态建立，分为主动模式与被动模式。在如今的网络环境下，由于客户端常位于防火墙或NAT之后，被动模式（PASV）更为常用，因为它由客户端连接服务端开放的数据端口，避免了主动模式中服务端回连被阻断的问题。

Python的ftplib模块将FTP交互封装为FTP类。实例化后调用connect方法连接主机，再调用login方法提交凭据。模块内部已经处理了命令编码、响应解析等细节，开发者只需关注业务逻辑。对于XML这类文本型但结构敏感的文件，必须采用二进制方式下载，以防止换行符转换导致节点破损。

1.1 建立连接与登录

下面代码展示了最基础的连接与登录过程。设置超时参数可以防止网络挂起导致脚本无限等待。调试级别可开启以观察命令交互，但在生产环境应关闭。

from ftplib import FTP

# 创建FTP对象并设置超时
ftp = FTP()
ftp.connect('192.168.0.1', 21, timeout=10)
# 使用账号密码登录，匿名可传空字符串
ftp.login(user='testuser', passwd='testpass')
print(ftp.getwelcome())
ftp.close()

上述示例中，connect的第三个参数为超时秒数，login成功后可通过getwelcome查看服务端欢迎信息。务必在脚本结尾或异常分支中调用close释放连接，否则可能占用服务端会话资源。

1.2 被动模式说明

ftplib默认在每次数据操作前设置被动模式。可通过set_pasv方法显式控制：传入True表示被动，False表示主动。如果公司网络限制出站端口，被动模式通常更可靠。

ftp.set_pasv(True)  # 开启被动模式，默认即为True

当遇到数据连接建立失败的错误时，首先应确认防火墙是否放行了对应的动态端口范围，而不是急于修改代码逻辑。

二、下载XML文件的完整实现

下载的核心是使用retrbinary方法，它接受一条FTP命令（如RETR 文件名）和一个本地写入回调。由于XML必须原样保存，回调中应以二进制追加方式写文件。下面示例包含切换目录、下载与基础校验。

2.1 单文件下载示例

以下脚本登录后进入xml_dir目录，将data.xml保存到本地同名词文件，并打印传输字节数。

from ftplib import FTP

def download_xml():
    ftp = FTP()
    ftp.connect('192.168.0.1', 21, timeout=15)
    ftp.login('testuser', 'testpass')
    ftp.cwd('/xml_dir')  # 切换到存放XML的目录
    local_name = 'data.xml'
    with open(local_name, 'wb') as f:
        # retrbinary以二进制获取，回调写文件
        ftp.retrbinary('RETR data.xml', f.write)
    ftp.quit()
    print('XML文件下载完成')

if __name__ == '__main__':
    download_xml()

这里使用ftp.quit()而非close，前者会发送QUIT命令优雅退出，后者直接关闭套接字。对于短期脚本，二者差异不大，但规范做法是用quit。

若远端文件名包含日期等动态部分，可先用nlst或mlsd列出目录，再用字符串匹配筛选目标XML，避免硬编码。

2.2 遍历目录批量下载

当需要将一整目录的XML同步到本地时，可结合mlsd获取文件属性，过滤出.xml结尾的条目逐个下载。

from ftplib import FTP
import os

def batch_download():
    ftp = FTP('192.168.0.1')
    ftp.login('testuser', 'testpass')
    ftp.cwd('/xml_dir')
    os.makedirs('local_xml', exist_ok=True)
    for name, info in ftp.mlsd():
        if name.endswith('.xml'):
            local_path = os.path.join('local_xml', name)
            with open(local_path, 'wb') as f:
                ftp.retrbinary('RETR ' + name, f.write)
            print('已下载', name)
    ftp.quit()

batch_download()

mlsd方法返回文件名与字典形式的元数据，比传统nlst更易判断类型。循环中拼接RETR命令时需注意文件名不含空格或特殊符，否则应做转义处理。

三、异常处理与稳定性优化

网络脚本必须考虑超时、认证失败与文件不存在等情况。ftplib会抛出特定异常，如socket.timeout、error_perm等，捕获后可使任务在定时器中具备自愈能力。

3.1 异常捕获结构

下面代码补充了try-except逻辑，并在出错时安全关闭连接，防止资源泄漏。

from ftplib import FTP, error_perm
import socket

def safe_download():
    ftp = FTP()
    try:
        ftp.connect('192.168.0.1', 21, timeout=10)
        ftp.login('testuser', 'testpass')
        ftp.cwd('/xml_dir')
        with open('safe.xml', 'wb') as f:
            ftp.retrbinary('RETR data.xml', f.write)
    except error_perm as e:
        print('权限或文件错误:', e)
    except socket.timeout:
        print('连接超时，请检查网络')
    finally:
        try:
            ftp.quit()
        except Exception:
            pass

safe_download()

error_perm对应FTP服务端返回4xx或5xx错误，例如550代表文件不存在。socket.timeout则在connect或数据传输阶段触发。finally块保证无论成败都尝试退出会话。

3.2 文件完整性校验

下载完成后可比对服务端文件大小与本地字节数。size方法能获取远端文件长度，避免传输中断造成残损XML。

from ftplib import FTP

ftp = FTP('192.168.0.1')
ftp.login('testuser', 'testpass')
ftp.cwd('/xml_dir')
remote_size = ftp.size('data.xml')
with open('check.xml', 'wb') as f:
    ftp.retrbinary('RETR data.xml', f.write)
local_size = f.tell() if False else os.path.getsize('check.xml')
if remote_size == local_size:
    print('大小一致，下载完整')
else:
    print('大小不符，可能中断')
ftp.quit()

这种校验虽简单，但能拦截多数半截文件问题。若业务对内容敏感，还可在本地用XML解析库尝试加载，捕获解析异常作为二级校验。

四、将脚本嵌入定时任务

写完下载逻辑后，可借助操作系统定时功能周期执行。Linux下用crontab，Windows下用任务计划程序。脚本本身应支持命令行参数指定远端路径与本地目录，提升复用性。

4.1 参数化改造

使用argparse接收主机、用户、密码与文件路径，使同一脚本适应多套环境。

import argparse
from ftplib import FTP

parser = argparse.ArgumentParser()
parser.add_argument('--host', default='192.168.0.1')
parser.add_argument('--user', required=True)
parser.add_argument('--passwd', required=True)
parser.add_argument('--remote', default='/xml_dir/data.xml')
parser.add_argument('--local', default='out.xml')
args = parser.parse_args()

ftp = FTP()
ftp.connect(args.host, 21, timeout=10)
ftp.login(args.user, args.passwd)
with open(args.local, 'wb') as f:
    ftp.retrbinary('RETR ' + args.remote, f.write)
ftp.quit()

参数化后，运维人员无需改代码即可调整目标。配合日志输出，能快速定位某次失败的原因。注意密码以明文传参存在安全隐患，生产环境建议从配置文件或环境变量读取。

通过上述步骤，我们实现了从登录FTP、切换目录、二进制下载XML到异常防护与定时化的完整链路。掌握ftplib的基本方法并重视被动模式与二进制写入，就能轻松应对各类FTP文件获取需求。

PythonFTPXML_download修改时间：2026-08-06 16:36:48