goftp.Client上传失败主因是地址格式错误、端口不符、权限不足、路径不合法、超时未设及登录认证问题；需手动解析URL、显式指定端口、确认目录可写、使用相对路径、设置超时与二进制模式、启用Debug日志定位。
goftp.Client 上传文件时连接被拒绝？检查地址格式和端口
常见错误是直接传 "ftp://example.com" 给 goftp.Dial，它不支持 URL 解析。必须拆成主机+端口，且默认 FTP 是明文协议、21 端口——但很多服务实际监听在 2121 或启用了被动模式（PASV）防火墙拦截。
- 用
net.ParseIP(host)确认 DNS 能解析，别卡在域名阶段 - 显式指定端口：传
"example.com:21"而非"example.com"，避免系统默认连 localhost - 如果服务跑在非标端口（比如 2121），
goftp.Dial("example.com:2121")必须写全，库不会自动 fallback - 遇到
connection refused，先 telnet 测试：telnet example.com 21，排除网络/防火墙问题
Upload 函数报错 “553 Could not create file”？权限与路径是关键
goftp.Client.Upload 底层发的是 STOR 命令，失败通常不是代码问题，而是服务端限制：目标目录不可写、路径不存在、或用户名没权限创建文件。
- 路径必须是**相对 FTP 根目录的路径**，比如用户登录后默认在
/home/user，想传到/home/user/uploads/a.txt，就传"uploads/a.txt"，不是"/uploads/a.txt" - 确保目标目录已存在，
goftp不自动创建父目录；可先调client.MakeDir("uploads") - 注意文件名编码：FTP 协议不强制 UTF-8，中文名可能被截断或乱码，优先用 ASCII 文件名测试
- 某些服务器要求先
CWD切工作目录，再 Upload，此时用client.ChangeDir("uploads")+Upload("a.txt", ...)
上传大文件卡住或超时？调整 TransferOptions 和底层连接
默认 goftp 使用阻塞式 TCP 连接，没设超时，大文件上传遇网络抖动会 hang 住，且不支持断点续传。
- 设置连接与传输超时：
&goftp.Options{Timeout: 30 * time.Second, ConnectionTimeout: 10 * time.Second} - 上传时加
goftp.TransferOptions{Mode: goftp.Binary}，避免文本模式自动换行损坏二进制文件 - 不要直接传
*os.File，先用os.Open打开，传io.Reader接口；若需进度反馈，包一层自定义io.Reader记录读取字节数 - 底层 net.Conn 没重试逻辑，出错就得手动重连再重传，别指望
Upload自动恢复
为什么 Login 总返回 “530 Login incorrect”？账号密码之外还有坑
FTP 登录失败不一定是密码错。goftp 默认走 USER/PASS 流程，但有些服务要求特定顺序、空密码、或隐式 TLS。
立即学习“go语言免费学习笔记（深入）”；
- 确认是否需要匿名登录：用
goftp.Dial("example.com:21", goftp.WithUsername("anonymous"), goftp.WithPassword("")) - 某些服务禁用明文密码，强制 FTPS（FTP over TLS），此时得用
goftp.DialTLS并提供tls.Config - 用户名区分大小写，空格易被忽略；密码含特殊字符（如
@、/）要确认服务端是否转义 - 部分服务器对同一 IP 登录频率有限制，频繁试错会被临时封，换 IP 或等几分钟再试
FTP 协议本身没有标准错误分类，同一个错误码（比如 550）在不同服务上含义可能完全不同。调试时一定要抓 goftp 的底层日志——启用 goftp.WithDebugWriter(os.Stderr)，看真实交互命令和响应，比猜快得多。
