aioftp 不能直接用 async with ClientSession() 传文件，因默认不自动连接，需显式传入地址参数或调用 connect()；并发上传应复用同一 ClientSession 实例以减少开销，但控制命令仍串行执行；断点续传需手动实现 REST 且兼容性差；空闲超时问题须配置 timeout 和 keepalive 或手动发 NOOP。
为什么 aioftp 不能直接用 async with 连接后就传文件？
常见错误是写成这样：
async def upload():
async with aioftp.ClientSession() as client:
await client.upload(<code>local_path</code>, <code>remote_path</code>)
这会报 RuntimeError: ClientSession is not connected。因为 aioftp.ClientSession 默认不自动连接，它只负责管理连接生命周期，真正建立 TCP 连接需显式调用 connect() 或在上下文进入时传入地址。
- 正确做法是：把服务器地址、端口、账号密码全塞进
ClientSession初始化参数里，它才会在async with进入时自动连接 - 或者手动调用
await client.connect(...)+await client.login(...)，但容易漏掉异常处理 - 注意：如果服务端启用了 FTPS（隐式 TLS），得额外加
secure=True和 SSL 上下文，否则连接会卡住或被重置
并发上传多个文件时，aioftp 的连接复用机制怎么影响性能？
每个 ClientSession 实例默认独占一个控制连接（control connection），数据连接（data connection）按需新建。这意味着：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 如果你为每个文件都新建一个
ClientSession（比如在asyncio.gather()里循环创建），会触发大量 TCP 握手和登录开销，反而比同步还慢 - 推荐方式：复用同一个
ClientSession实例，用asyncio.create_task()或gather()并发调用它的upload()方法 - 但要注意：FTP 协议本身不支持真正的“多路复用”，
aioftp是靠内部锁（_control_lock）串行化控制命令。所以并发上传时，STOR命令仍会排队，实际是并发打开数据通道，但控制流仍是串行的 - 实测发现，10 个 1MB 文件，复用 session 比每个文件新建 session 快 3–5 倍
如何安全处理上传中断并实现断点续传？
aioftp 原生不支持断点续传（REST），也不提供上传进度回调。强行自己实现 REST 需要：
立即学习“Python免费学习笔记（深入）”；
- 先用
client.stat(<code>remote_path) 获取远端文件大小（若存在） - 本地用
os.path.getsize()对比，若远端更小，再发REST命令，然后用client._open_data_connection()（私有方法，不稳定）跳过已传部分 - 但多数 FTP 服务器对
REST支持不一致；ProFTPD 可能要求REST后紧跟APPE而非STOR；vsftpd 则可能拒绝非 0 的REST值 - 更稳妥的做法：上传前先生成本地文件哈希，上传后调用
client.stat()+client.download()拉取远端片段校验，失败则删除重传
遇到 ConnectionResetError 或 BrokenPipeError 怎么办？
这类错误在长连接空闲后高频出现，根本原因是 FTP 服务器设置了 idle timeout（常见 300 秒），而 aioftp 默认不发 NOOP 心跳。
- 解决方案：在
ClientSession初始化时加上timeout=60（单位秒），并配合keepalive=True - 注意：
keepalive参数仅在aioftp >= 0.20.0中可用；旧版本需自己写心跳协程，每 45 秒发一次await client.command("NOOP") - 另一个坑：某些 NAT 网关会静默丢弃空闲 FTP 数据连接，此时即使控制连接活着，
upload()仍会卡死或抛TimeoutError。建议设data_connection_timeout=30显式控制数据通道超时
upload() 调用就能覆盖所有场景——连接策略、错误恢复、服务器兼容性，每一项都要单独验证。 
