C++实现FTP上传_使用libcurl操作网络文件

必须启用被动模式（PASV）才能在现代网络中成功上传，关键选项包括CURLOPT_URL（含凭据）、CURLOPT_UPLOAD、CURLOPT_READDATA、CURLOPT_FTP_USE_PASV=1L；禁用EPSV可提升兼容性；错误处理需关注CURLE_LOGIN_DENIED、CURLE_REMOTE_FILE_NOT_FOUND等码；大文件须流式读取并设CURLOPT_INFILESIZE_LARGE和超时参数；FTP上传不可用HTTP相关选项。

如何用 libcurl 在 C++ 中上传文件到 FTP 服务器

libcurl 支持 FTP 上传，但默认是主动模式（PORT），很多现代网络环境（如 NAT、防火墙）会阻断数据连接。必须显式启用被动模式（PASV），否则 CURLE_COULDNT_CONNECT 或超时是大概率事件。

关键不是“能不能传”，而是“怎么让连接通”。上传本身只需设置几个选项，难点在连接建立阶段。

• curl_easy_setopt(curl, CURLOPT_URL, "ftp://user:pass@host/path/file.txt") —— URL 必须含完整凭据和目标路径，不能只写域名
• curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L) —— 启用上传模式（不是 POST）
• curl_easy_setopt(curl, CURLOPT_READDATA, &file_handle) —— 绑定已打开的 FILE*，libcurl 会从中读取内容
• curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L) —— 强制禁用 EPSV（IPv6 扩展 PASV），避免某些老 FTP 服务器不兼容
• curl_easy_setopt(curl, CURLOPT_FTP_USE_PASV, 1L) —— 必开，否则大概率连不上数据通道

处理 FTP 上传中的常见错误码

上传失败时，curl_easy_perform() 返回非零值，需结合 curl_easy_strerror() 和 HTTP/FTP 状态码判断原因。最常遇到的不是认证失败，而是路径或权限问题。

• CURLE_LOGIN_DENIED：用户名/密码错，或服务器拒绝该用户 FTP 登录（注意：有些服务器关闭 FTP 账号，只留 SFTP）
• CURLE_REMOTE_FILE_NOT_FOUND：目标目录不存在，libcurl 不自动创建父目录，需提前用 ftp://.../path/ + CURLOPT_CUSTOMREQUEST "MKD path" 手动建
• CURLE_FTP_COULDNT_STOR_FILE：权限不足（如目标目录不可写）、磁盘满、或文件名含非法字符（空格、中文未编码）
• CURLE_OPERATION_TIMEDOUT：90% 是 PASV 模式被防火墙拦截，检查是否设置了 CURLOPT_FTP_USE_PASV

上传大文件时如何避免内存暴涨和超时

libcurl 默认会把整个文件读入缓冲区再发，对大文件极不友好。必须配合流式读取 + 合理超时控制，否则程序卡死或被服务器断连。

• 用 fopen(..., "rb") 打开文件，传给 CURLOPT_READDATA，libcurl 内部按需调用 fread()
• curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)file_size) —— 显式告知大小，避免 libcurl 自己 fseek(SEEK_END)（某些文件系统不支持）
• curl_easy_setopt(curl, CURLOPT_TIMEOUT, 300L) —— 总超时设长些；CURLOPT_LOW_SPEED_LIMIT 和 CURLOPT_LOW_SPEED_TIME 可防慢速挂起
• 不要用 std::string 或 std::vector 全局加载文件——这是新手最常踩的内存坑

为什么 CURLOPT_POST 和 CURLOPT_HTTPPOST 不能用于 FTP 上传

因为 FTP 不是 HTTP 协议。CURLOPT_POST 仅对 HTTP/HTTPS 有效，强行设了也无作用；CURLOPT_HTTPPOST 是 multipart/form-data 专用，和 FTP 完全无关。混淆这两者会导致静默失败——curl 返回 CURLE_OK，但服务器根本没收到文件。

FTP 上传唯一正路是 CURLOPT_UPLOAD + CURLOPT_READDATA。如果看到示例混用 HTTP 选项，基本可以判定它跑不通 FTP。

另外注意：libcurl 的 FTP 支持默认编译进库，但如果你用的是精简版（比如 Android NDK 自带的 curl），可能不含 FTP 协议，此时 curl_version_info(CURLVERSION_NOW)->features & CURL_VERSION_FTP 会返回 0，得换全量库。