最稳妥的FTP上传方式是使用.NET原生FtpWebRequest,需显式设置Method(UploadFile)、Credentials(含匿名空凭据)、UseBinary=true,上传流用GetRequestStream()获取并手动Close(),大文件须设Timeout和ReadWriteTimeout为30分钟。

用 FtpWebRequest 上传单个文件最稳妥
直接走 .NET 原生的 FtpWebRequest 是目前最可控、兼容性最好的方式,尤其适合 Windows Server 或 .NET Framework 环境。它不依赖第三方包,出错时错误信息也相对明确。
关键点在于必须显式设置 Method、Credentials 和 UseBinary,漏掉任意一个都可能上传空文件或报 550 错误:
-
Method必须设为WebRequestMethods.Ftp.UploadFile(不是STOR字符串) -
Credentials要提前 new,不能等发请求时才填;匿名 FTP 也要传new NetworkCredential("", "") -
UseBinary设为true,否则文本模式会损坏图片、ZIP 等二进制文件 - 上传流必须用
GetRequestStream()获取,写完立刻Close(),不能用using包裹流——否则底层连接可能提前断开
上传大文件时得手动分块 + 设置超时
FtpWebRequest 默认超时只有 100 秒,传几百 MB 文件大概率触发 WebException:「操作已超时」。这不是网络问题,是客户端硬限制。
解决方法是显式延长两个超时:
-
Timeout控制整个请求生命周期(建议设为30 * 60 * 1000,即 30 分钟) -
ReadWriteTimeout控制流读写阻塞时间(同样建议 30 分钟,否则大文件写到一半就卡死) - 如果仍不稳定,可改用分块上传:每次只
Write()64KB,中间不 Sleep,靠超时参数兜底
注意:Timeout 在 .NET Core 6+ 已被标记为 obsolete,但 .NET Framework 4.8 及大多数生产环境仍在用,别盲目删。
删除/重命名远程文件必须用 FtpWebRequest 的对应 Method
很多人以为上传和删文件能共用同一套逻辑,其实不行。FtpWebRequest 对每个操作都强制要求指定 Method,且不能混用:
- 删文件:用
WebRequestMethods.Ftp.DeleteFile,请求体必须为空,否则 501 错误 - 重命名:用
WebRequestMethods.Ftp.Rename,然后在Headers["Rename-to"]里塞目标路径(不是 query 参数!) - 列目录:用
WebRequestMethods.Ftp.ListDirectoryDetails,返回的是原始 FTP 服务器格式字符串,需自己解析权限、时间、名字
所有操作都要重新 new 一个 FtpWebRequest 实例,复用对象会导致状态残留,比如上次上传的 ContentLength 影响本次删除。
遇到 530 Not logged in 别急着查密码
这个错误八成不是账号错,而是 FTP 服务器启用了被动模式(PASV),而你的客户端没配好数据通道。
.NET 的 FtpWebRequest 默认开启被动模式,但某些防火墙或 NAT 设备会拦截 PASV 返回的随机端口。临时验证方法是关掉它:
- 加一句
request.EnableSsl = false(即使不用 SSL,设 false 才真正禁用加密握手干扰) - 再加
request.UsePassive = false,切回主动模式(PORT)——前提是服务器允许且客户端出口防火墙放行 20 端口
更可持续的解法是让运维在 FTP 服务端配置 PASV 端口范围(如 50000–50100),然后在客户端防火墙放行该范围,并设置 request.Proxy = null 防止代理干扰。











