FluentFTP连接失败多因模式或配置错误：需据服务器选PASV/PORT、设FTPES加密与证书验证；上传下载须用Binary模式、异步并发控制、路径标准化及超时设置；中文路径要发OPTS UTF8 ON；关键操作后应校验结果。
FluentFTP 连接 FTP 服务器总提示“Authentication failed”
多数情况不是密码错了，而是没设对 ConnectOptions 或忽略了 FTP 模式差异。被动模式（PASV）是默认，但内网/NAT 后的服务器常需要主动模式（PORT），或反过来——某些云 FTP（如 Azure App Service 的 FTPS）强制要求 PASV + TLS。
- 先确认服务器是否支持 FTPS（隐式/显式）：用 FileZilla 测试，记下登录时实际使用的协议和端口
- 显式 FTPS（FTPES）要设
client.EncryptionMode = FtpEncryptionMode.Explicit，且client.ValidateCertificate += (c, e) => true;（仅开发环境绕证书验证） - 若用 IP 直连却失败，检查
client.Host是否含端口号（如"192.168.1.100:21"），FluentFTP 不自动拆分 host/port，必须手动传new FtpClient(host, port, user, pass) - 用户名含
@（如邮箱）时，部分 FTP 服务会解析异常，改用client.Credentials = new NetworkCredential("user@domain", "pwd")更稳
批量上传文件时 CPU 占用高、卡死在 UploadFile
默认单线程串行上传，大文件多任务时不仅慢，还会因超时重试堆积连接。FluentFTP 的 UploadFiles 方法虽支持列表，但底层仍是循环调用 UploadFile，没解决并发瓶颈。
- 用
UploadFilesAsync替代同步方法，配合Parallel.ForEachAsync控制并发数（推荐 3–5，避免服务器拒绝连接） - 务必设置超时：
client.ReadTimeout = 30000; client.DataConnectionConnectTimeout = 30000;，否则一个卡住的文件会让整个批次挂起 - 本地路径含中文或特殊字符时，
UploadFiles可能静默失败，先用Path.GetFullPath标准化路径再传入 - 不要在循环里反复
client.Connect()，复用已连接的 client 实例；但注意它不是线程安全的——并发上传需为每个任务新建 client 或加锁
下载文件后发现内容损坏或大小不一致
常见于未正确处理二进制流或忽略 FTP 传输模式。FluentFTP 默认按 ASCII 模式传输，图片、ZIP、EXE 等二进制文件必须切到 Binary 模式，否则换行符会被悄悄转换。
- 下载前强制设
client.TransferMode = FtpTransferMode.Binary（上传同理） - 用
DownloadFile而非Download：后者返回byte[]，大文件易 OOM；前者直接写磁盘，可控性强 - 检查
FtpResult返回值，别只看是否抛异常——DownloadFile成功但返回FtpResult.Failed时，可能只是部分字节写入 - 若目标路径父目录不存在，
DownloadFile不自动创建，得提前用Directory.CreateDirectory
删除/重命名远程文件时提示“550 Permission denied”
不是权限配置问题，而是 FluentFTP 默认不发送 OPTS UTF8 ON，导致含中文或 Unicode 字符的路径被服务器截断或识别错误。尤其在 Linux FTP 服务（vsftpd/proftpd）上高频出现。
- 连接后立即执行
client.Execute("OPTS UTF8 ON")（即使返回非 2xx 也无妨，多数服务器会静默接受） - 重命名用
Rename方法，别拼接DELE+STOR：前者原子操作，后者在网络中断时会留残缺文件 - 删除目录用
DeleteDirectory，它会递归清理；但若目录非空且服务器禁用RMD，会失败——先GetListing判断是否为空更稳妥 - 注意：
DeleteFile对软链接（symlink）行为不一致，Linux vs Windows FTP 服务处理方式不同，生产环境建议先GetListing确认类型
最麻烦的其实是 FTP 服务器本身的状态不可见：没有事务、没有原子移动、连接随时可能被中间设备掐断。所以关键操作后，最好补一次 GetFileSize 或 GetListing 校验结果，而不是只信返回码。
