使用Python Paramiko上传本地CSV到SFTP报FileNotFoundError的解决方法
Paramiko SFTP批量上传报错根因与修正方案
核心错误定位
- 接口使用完全错位:
sftp_con.listdir()是SFTP客户端提供的远程目录枚举方法,只能读取远程服务器指定路径下的文件列表,根本无法访问本地磁盘内容。原代码用这个方法扫描本地待上传文件,本身逻辑就不成立。之前能打印出部分文件名,是因为传入本地Windows路径后,远程SFTP把这段字符当成了相对路径,返回了工作目录下碰巧和本地文件名重名的条目,并非真的扫描到了本地文件,因此才会出现“打印的本地路径存在,但系统提示文件找不到”的矛盾情况。 - 路径拼接无规范:原代码直接用字符串拼接组合本地、远程文件路径,没有处理路径分隔符缺失、跨系统路径格式差异的问题,很容易生成畸形路径导致文件定位失败。
修正后可直接运行的实现
import paramiko import re import os def put_server_files(local_path, host, port, username, remote_path, file_pattern): # 替换为本地私钥文件的实际存储路径 privkey = "C:/path/to/my/private/key.pem" ssh_con = paramiko.SSHClient() ssh_con.set_missing_host_key_policy(paramiko.AutoAddPolicy()) private_key = paramiko.RSAKey.from_private_key_file(privkey) ssh_con.connect(host=host, port=port, username=username, pkey=private_key) sftp_con = ssh_con.open_sftp() # 用本地os接口枚举本地目录文件,替代错误的sftp.listdir调用 all_local_files = os.listdir(local_path) match_rule = re.compile(file_pattern) matched_files = list(filter(match_rule.match, all_local_files)) for file_name in matched_files: # 用os.path.join拼接本地路径,自动适配Windows/Linux路径规则 file_local = os.path.join(local_path, file_name) # 远程路径统一替换为正斜杠,适配Linux远程服务器的路径格式 file_remote = os.path.join(remote_path, file_name).replace("\\", "/") print(f"开始传输:{file_local} >>> {file_remote}") sftp_con.put(file_local, file_remote) sftp_con.close() ssh_con.close() # 服务器连接配置列表 list_of_servers = [ { 'host': 'myhost', 'port': 22, 'username': 'myusername', 'remote_path': '/dev/', 'file_pattern': r'^ZEBASE.*\.csv$' # 精确匹配ZEBASE开头的CSV文件,避免误传 } ] # 本地待上传文件的存储目录 local_path = r"C:/Users/rpa2224/Desktop/projpython/FilesCSV" for server_config in list_of_servers: put_server_files(local_path, **server_config)
实操注意事项
- 正则匹配规则可根据需求调整:原代码使用的
ZEBASE匹配规则会命中所有文件名开头带ZEBASE的文件,建议优化为带文件后缀的精确规则,避免误传无关文件。 - 所有配置路径(私钥路径、远程存储路径、本地文件目录)需替换为实际环境的真实值,不要保留示例占位符。
- 若远程目录不存在对应层级的文件夹,需提前通过
sftp.mkdir()创建对应路径,避免上传失败。
内容的提问来源于stack exchange,提问作者Rafael Albuquerque
相关产品推荐
相关产品推荐

