curl_easy_setopt设置curlopt_readfunction时，回调函数必须严格符合size_t()(char,size_t,size_t,void*)签名，返回实际读取字节数（≤size×nmemb且非负），并正确处理userdata偏移、文件末尾和errno；否则易触发curle_send_error或上传空内容。
curl_easy_setopt设置CURLOPT_READFUNCTION时容易传错参数类型
libcurl上传文件的核心是用CURLOPT_READFUNCTION接管数据读取，但很多人直接传fread或自己写的函数却不匹配签名，导致崩溃或上传空内容。libcurl要求回调函数必须是size_t (*read_callback)(char *ptr, size_t size, size_t nmemb, void *userdata)形式，返回实际读取的字节数（不是size_t nmemb，而是size * nmemb中的有效字节数）。
常见错误：read_callback里忘了把size * nmemb作为缓冲区上限，或者返回-1但没设errno，libcurl会直接中止上传。
- 务必用
static或全局函数实现回调，避免lambda捕获导致的生命周期问题 - 如果上传的是内存中已加载的文件，
userdata应指向该内存块和当前偏移，每次回调更新偏移并返回剩余数据长度 - 文件未读完就返回0，libcurl会认为传输结束——这常被误用作“断点续传”，其实只是提前终止
用CURLOPT_UPLOAD和CURLOPT_INFILESIZE控制上传行为
启用上传不能只靠CURLOPT_UPLOAD设为1L，还必须显式告知数据长度，否则libcurl可能卡在等待更多输入的状态（尤其HTTP/1.1服务器不支持chunked编码时）。CURLOPT_INFILESIZE设为文件字节大小是最稳妥的方式；若大小未知且必须流式上传，才考虑CURLOPT_HTTPHEADER手动加Transfer-Encoding: chunked，但这依赖服务器支持，且libcurl 7.56.0+才默认启用chunked。
-
CURLOPT_INFILESIZE设为-1L表示大小未知，此时必须配合CURLOPT_READFUNCTION且不能设CURLOPT_INFILE - 若同时设了
CURLOPT_INFILE（FILE*）和CURLOPT_READFUNCTION，后者会覆盖前者，但CURLOPT_INFILESIZE仍需正确设置 - 上传大文件时，建议用
CURLOPT_BUFFERSIZE调大到8192或更高，减少系统调用次数
POST还是PUT？选错HTTP方法会导致405或静默失败
很多服务器对POST和PUT权限区分严格。libcurl默认用POST，但文件上传接口通常要求PUT（尤其RESTful设计）。仅设CURLOPT_CUSTOMREQUEST为"PUT"还不够——必须同时禁用CURLOPT_POST（设为0L），否则libcurl内部逻辑会冲突，可能发成POST或报Protocol error。
- 上传到PHP后端（如
$_FILES）必须用POST+multipart/form-data，这时要用curl_formadd构造表单，而非CURLOPT_READFUNCTION - 上传到Node.js/Python Flask等接收原始body的接口，用
PUT更直接，且无需解析form，但需确保Content-Type与服务端期望一致（如application/octet-stream） - 调试时用
CURLOPT_VERBOSE开日志，重点看请求行是否真为PUT，以及Content-Length是否匹配预期
错误码CURLE_SEND_ERROR往往意味着回调返回值不对
调用curl_easy_perform返回CURLE_SEND_ERROR（26）时，90%的情况不是网络问题，而是READFUNCTION回调返回了非法值：比如返回负数但没设errno，或返回大于size * nmemb的数值，或多次回调返回0。libcurl不会告诉你具体哪次回调出错，只能靠日志打点排查。
- 在回调开头加
assert(ptr && userdata);，避免空指针解引用 - 每次返回前打印
return len（len为本次读取字节数），确认它始终≤size * nmemb且非负 - 上传完成后检查
CURLINFO_SIZE_UPLOAD，若远小于文件大小，说明回调提前结束了
真正难调的不是怎么写，而是怎么让回调函数在各种边界条件下（文件末尾、读取中断、内存不足）都返回libcurl能理解的值。多数人卡在这里，而不是语法或链接问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
