先确认适用条件

适用于 curl 提示 Failed writing received data 或返回错误 23。本文处理下载响应在本机写入失败;磁盘根目录整体无法访问、文件系统损坏或远程服务端存储失败,需要分别处理。

先区分原因与影响范围

curl 接收数据后会写入文件或标准输出。输出目录不存在、当前账户不能写入、空间不足,或管道下游提前退出,都可能在写入阶段失败。网络已开始传输与文件完整保存是两件事。

按顺序检查,每次只改一项

  1. 看原命令把响应送到哪里:--output/-o 指定的文件、> 重定向文件,还是 | 后面的程序。保留原文件,改用一个新文件名做对照。
  2. 在自己的用户目录内新建一个空测试文件夹,用文件管理器尝试保存一个小文本文件,并检查剩余空间。若这一步失败,先修输出位置,不要默认提权或关闭安全软件。
  3. 用 curl 的 --output 写到该文件夹,暂时移除后面的解析管道。若直接落盘成功而管道失败,检查下游程序是否读够内容就退出,或解析时因错误关闭了输入。
  4. 确实只是子目录不存在时,可先创建目录,或对明确的本地输出路径使用 --create-dirs。该选项不会解决磁盘已满、只读挂载和权限拒绝。
macOS / Linux shell;在可写空目录执行,会创建 download-check 子目录和新文件;Windows 用 curl.exe 并在 PowerShell 查看 $LASTEXITCODE
curl -q --create-dirs --output "./download-check/result.html" --connect-timeout 10 --max-time 20 "https://example.com/"
echo "$?"

怎样确认已经恢复

退出码应为零,输出文件应存在且内容符合预期;下载配置还要通过客户端格式检查。不能以网页返回 200 或文件大小大于零判断已经保存完整。

未恢复时如何回退与求助

本轮只改输出位置,可恢复原命令并保留原文件。删除经确认的测试文件即可;不要递归修改整块磁盘权限。如果可写目录仍报错,记录完整错误、磁盘空间和有无管道,进一步检查本地存储。