使用pysftp传输文件时如何验证上传操作是否成功？

仅通过put返回值比对文件大小，是否足以验证传输成功？ #

不足以。

• 文件大小校验只能识别传输中断、写入缺失这类导致最终文件体积和源文件不一致的故障，两类高频传输异常完全无法通过大小比对检出：
  • 传输过程中出现比特翻转：受网络链路噪声、服务端磁盘写入错误等影响，文件可能出现单比特或多比特错误，此时文件体积和源文件完全一致，但内容已经损坏
  • 异常截断刚好匹配源文件大小：网络闪断、服务端写入流异常关闭时，有可能刚好写入了和源文件等大的无效数据（比如空字节填充、残缺块），大小校验会误判为传输成功
• 另外要注意：put接口返回的SFTPAttributes中的文件大小字段，来自服务端写入完成后返回的文件元数据，本身没有经过内容一致性校验，仅能证明服务端上报该文件当前占用的存储空间大小，无法证明写入内容和源文件一致。

打开远程文件调用check方法校验是否可行？ #

该方法不具备通用可靠性，不能作为默认校验方案。

• check是SFTP协议的可选扩展接口，逻辑是请求服务端自行计算指定文件片段的哈希值返回给客户端，不需要客户端下载全量文件，理论上校验效率很高，但存在明显的局限性：
  • 兼容性极差：绝大多数默认部署的SFTP服务端（包括默认配置的OpenSSH）都没有实现这个扩展接口，直接调用会抛出异常
  • 一致性无法保证：即使服务端支持该接口，不同实现采用的哈希算法、分块计算逻辑没有强制统一标准，部分自定义服务端实现甚至会返回错误的校验值，反而导致校验结果误判
  • 易用性差：该接口默认针对文件片段设计，校验全文件需要手动指定从0字节到文件末尾的完整范围，参数配置错误很容易出现漏检。

推荐的可靠传输校验方案 #

• 兼容性最高、最稳妥的方案是做全量内容哈希校验：本地预计算源文件的哈希值（推荐选择SHA-256算法，兼顾校验速度和冲突概率），文件上传完成后，将远程文件全量读取到内存或临时目录，计算哈希值和本地值比对，完全一致才判定传输成功。如果拥有服务端的SSH命令执行权限，也可以直接在服务端执行哈希计算命令拉取结果比对，避免下载文件占用带宽。
• 大文件传输场景可以做分级校验：优先探测服务端是否支持check接口扩展，确认双方哈希算法、计算逻辑一致的前提下可以用check做快速校验，不满足条件时降级到全量哈希比对。
• 上传时可以传入preserve_mtime=True参数保留源文件的修改时间，在哈希校验之外补充元数据比对，进一步降低异常漏检概率。

基础校验逻辑参考代码：

import pysftp
import hashlib

def calc_local_sha256(file_path):
    hash_obj = hashlib.sha256()
    with open(file_path, 'rb') as f:
        # 分块读取大文件避免内存溢出
        for chunk in iter(lambda: f.read(1024 * 1024), b''):
            hash_obj.update(chunk)
    return hash_obj.hexdigest()

# 上传+校验流程示例
cnopts = pysftp.CnOpts()
with pysftp.Connection('sftp服务地址', username='账号', password='密码', cnopts=cnopts) as sftp:
    local_file = '/本地路径/目标文件.bin'
    remote_file = '/远程路径/目标文件.bin'
    # 执行上传
    sftp.put(local_file, remote_file, preserve_mtime=True)
    # 计算本地文件哈希
    local_hash = calc_local_sha256(local_file)
    # 读取远程文件计算哈希
    remote_hash_obj = hashlib.sha256()
    with sftp.open(remote_file, 'rb') as rf:
        for chunk in iter(lambda: rf.read(1024 * 1024), b''):
            remote_hash_obj.update(chunk)
    remote_hash = remote_hash_obj.hexdigest()
    # 比对结果
    if local_hash != remote_hash:
        raise IOError("传输异常：文件内容哈希不匹配")

内容的提问来源于stack exchange，提问作者zhipeng wang