C++如何调用FTP服务器上传下载？（libcurl集成示例）

libcurl上传ftp失败主因是连接模式与认证配置错误：需强制被动模式（curlopt_ftp_use_pasv=1l）、单独设curlopt_userpwd、指定完整url路径；下载大文件须用流式写入回调并正确返回字节数；windows链接需匹配架构与ssl版本，上传前必设curlopt_upload再设大小。

libcurl上传文件到FTP服务器失败，常见报错CURLE_COULDNT_CONNECT或CURLE_LOGIN_DENIED

连不上或认证失败，大概率不是代码逻辑问题，而是FTP连接模式和认证细节没对上。libcurl默认走主动模式（PORT），但大多数现代FTP服务器（尤其带NAT/防火墙的）只接受被动模式（PASV）。另外，ftp:// URL里写密码会被部分版本忽略，必须用curl_easy_setopt单独设CURLOPT_USERPWD。

• 强制启用被动模式：curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L)（禁用EPSV）+ curl_easy_setopt(curl, CURLOPT_FTP_USE_PASV, 1L)
• 用户名密码别塞URL里，改用：curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass")
• 如果服务器用FTP over TLS（FTPS），得加：curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_ALL)，并确保libcurl编译时启用了OpenSSL
• 路径注意：FTP服务器根目录不一定是你登录用户的home，CURLOPT_UPLOAD前用CURLOPT_URL指定完整路径如ftp://host/path/to/file.txt，否则可能传到意外位置

下载大文件时卡住或内存暴涨，CURLOPT_WRITEFUNCTION回调怎么写才安全

直接用std::String拼接所有数据，几MB就OOM；不设CURLOPT_NOPROGRESS又可能被某些FTP服务器的进度响应干扰。关键在控制缓冲区粒度和避免拷贝。

• 回调函数里别做字符串拼接，用std::vector<uint8_t></uint8_t>或std::ofstream流式写入磁盘
• 示例安全写法：

  size_t write_cb(void* ptr, size_t size, size_t nmemb, void* userdata) {   std::ofstream* fp = static_cast<std::ofstream*>(userdata);   size_t realsize = size * nmemb;   fp->write(static_cast<char*>(ptr), realsize);   return realsize; }

• 务必检查返回值：libcurl要求回调返回**实际接收字节数**，少于size * nmemb会被视为传输中断
• 下载前加curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 1L)，避免FTP服务器发PROGRESS命令导致超时

Windows下编译链接libcurl失败，LNK2019: unresolved external symbol

不是头文件没包含，是libcurl的导入库（.lib）没连对，或者运行时DLL找不到。Windows的libcurl分静态/动态、带SSL/不带SSL多个版本，混用必炸。

• 确认你用的是libcurl.lib（不是curldll.lib），且与你的编译器架构一致（x64项目不能链x86版lib）
• 如果用了CURL_STATICLIB宏，必须定义：#define CURL_STATICLIB，且链接ws2_32.lib、wldap32.lib、crypt32.lib（SSL版还需libssl.lib和libcrypto.lib）
• 运行时报libcurl.dll missing？把对应DLL扔进exe同目录，或加到PATH——别指望系统路径有它
• 用dumpbin /dependents your_app.exe查实际依赖了哪些DLL，比猜靠谱

上传后文件内容损坏或长度不对，CURLOPT_INFILESIZE和CURLOPT_UPLOAD顺序不能错

libcurl需要提前知道上传文件大小，否则FTP服务器可能截断或拒绝。但CURLOPT_INFILESIZE必须在CURLOPT_UPLOAD设为1L之后调用，否则无效。

立即学习“C++免费学习笔记（深入）”；

• 正确顺序：curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L) → curl_easy_setopt(curl, CURLOPT_INFILESIZE, filesize) → curl_easy_setopt(curl, CURLOPT_READFUNCTION, ...)
• 如果文件大小不确定（比如管道输入），用CURLOPT_INFILESIZE_LARGE传CURL_OFF_T类型，并确保libcurl支持large file
• 读回调里返回0表示结束，但别提前close文件句柄——libcurl会在传输完才释放资源
• 上传后建议用CURLOPT_NOBODY + CURLOPT_HEADERFUNCTION发HEAD请求校验服务器端文件大小是否匹配

FTP协议本身没有事务和原子性，上传中途断开就是半截文件。真要可靠，得自己加MD5校验、断点续传逻辑，或者换SFTP（libssh2）。libcurl的FTP支持够用，但别把它当黑盒——每个curl_easy_setopt调用背后都有协议层含义。