curl: (23) Failed writing body (0 != 110) 是什么问题？

Question

**curl: (23) Failed writing body (0 != 110) 是什么问题？** 在使用 `curl` 进行网络请求时，出现 `curl: (23) Failed writing body (0 != 110)` 错误，通常表示 **写入响应体时发生错误**。具体来说，`curl` 在尝试将接收到的数据写入目标位置（如文件或回调函数）时失败，实际写入字节数与预期不符（此处 0 字节写入失败，期望写入 110 字节）。 常见原因包括： 1. **磁盘空间不足**：无法将数据写入本地文件，因存储空间已满； 2. **文件权限问题**：目标文件不可写或权限受限； 3. **输出流被关闭或中断**：如管道断裂或程序提前终止； 4. **回调函数处理不当**：在使用 `libcurl` 编程时，未正确实现 `WRITEFUNCTION` 回调； 5. **网络连接中断**：数据传输未完成即断开连接。 解决方法包括检查磁盘空间、文件权限、确保输出流可用，或调试回调函数逻辑。

Answer 1

curl: (23) Failed writing body (0 != 110) 是什么问题？

在使用 curl 进行网络请求时，出现 curl: (23) Failed writing body (0 != 110) 错误，通常表示 写入响应体时发生错误。具体来说，curl 在尝试将接收到的数据写入目标位置（如文件或回调函数）时失败，实际写入字节数与预期不符（此处 0 字节写入失败，期望写入 110 字节）。

1. 常见原因分析

• 磁盘空间不足：当目标文件路径所在磁盘空间已满，curl 无法写入数据。
• 文件权限问题：目标文件不可写，或用户没有写入权限（如使用 sudo 但目标路径权限仍受限）。
• 输出流被关闭或中断：例如通过管道将 curl 输出传递给其他命令时，下游命令提前退出，导致管道断裂。
• 回调函数处理不当：在使用 libcurl 编程接口时，未正确实现自定义的 WRITEFUNCTION 回调函数。
• 网络连接中断：服务器端提前关闭连接，数据未完全传输。

2. 排查与解决方法

1. 检查磁盘空间：
   使用如下命令查看磁盘使用情况：

   df -h

2. 验证文件写入权限：
   检查目标文件路径是否可写：

   ls -l /path/to/output/file

3. 测试输出流稳定性：
   如果使用管道或重定向，尝试直接输出到终端或文件：

   curl -o output.txt http://example.com/data

4. 调试 libcurl 回调逻辑：
   确保 WRITEFUNCTION 正确处理数据长度和返回值：

   size_t write_callback(char *ptr, size_t size, size_t nmemb, void *userdata) {
       size_t total = size * nmemb;
       // 实现数据写入逻辑
       return total; // 必须返回实际写入的字节数
   }

5. 检查网络连接状态：
   使用 ping 或 traceroute 检查是否网络中断：

   ping example.com

3. 典型场景与解决方案

场景	问题表现	解决方法
磁盘满	curl 报错 Failed writing body	清理磁盘或更换输出路径
权限不足	无法写入指定文件	修改文件权限或使用 sudo
管道中断	脚本中使用管道时报错	确保下游命令正常运行
libcurl 编程错误	自定义回调返回值错误	检查 WRITEFUNCTION 返回值

4. 调试建议与进阶思路

可以使用 strace 跟踪系统调用，查看具体在哪个步骤出错：

strace -f curl -o output.txt http://example.com/data

此外，使用 -v 参数可以查看详细的请求/响应过程：

curl -v http://example.com/data

对于使用 libcurl 的程序，启用 verbose 模式有助于排查：

curl_easy_setopt(handle, CURLOPT_VERBOSE, 1L);

5. 流程图分析

以下是一个典型的 curl 请求与写入流程图，用于帮助理解错误发生的位置：

graph TD
    A[开始请求] --> B[建立连接]
    B --> C[发送请求]
    C --> D[接收响应头]
    D --> E[接收响应体]
    E --> F{写入目标位置?}
    F -->|是| G[写入成功]
    F -->|否| H[触发 Failed writing body 错误]
    H --> I[检查磁盘、权限、回调等]
    I --> J[解决后重试]
    G --> K[结束]
    J --> G