先确认适用条件
适用于 curl 下载时明确返回退出码 63,或提示文件超过允许大小。重点检查本次命令的 --max-filesize;它限制文件大小,与控制每秒传输量的 --limit-rate 不是同一个选项。
先区分原因与影响范围
已知响应大小超过上限时,curl 可以在正文传输前拒绝下载。curl 8.4.0 起,对事先不知道大小的传输也会在达到阈值时中止;旧版本不能据此保证未知大小文件受到限制。失败后可能留下不完整文件。
按顺序检查,每次只改一项
- 运行 curl --version,保存原错误与命令中的大小上限。Windows 使用 curl.exe,查看退出码用 $LASTEXITCODE;macOS/Linux shell 使用紧接命令的 echo "$?"。
- 核对目标是不是预期文件:发布页可能提供了不同架构、完整包与增量包,也可能把请求重定向到另一份资源。先确认内容用途,不直接把上限改成无限。
- 用新建空目录和临时文件名做一次受限下载。下方 1048576 字节只是演示值,应依据预期资产大小和磁盘余量调整;已有正式配置不能作为测试输出。
- 若确实需要更大的合法文件,只提高这一次请求的上限。使用 --compressed 时还要核对本机版本对解压后大小的限制支持:当前手册注明 8.20.0 起扩展到自动解压过程,不将新版行为套给旧 curl。
curl -q --max-filesize 1048576 --connect-timeout 10 --max-time 30 --fail --output result.part "https://example.com/"
echo "$?"怎样确认已经恢复
记录退出码、实际保存的文件和内容校验结果。零退出码也需核对文件类型与哈希;错误 63 留下的 .part 文件不能当成完整安装包或配置导入。
未恢复时如何回退与求助
恢复原命令的上限即可撤销本轮参数调整,确认后删除失败的临时文件。若版本过旧而任务必须可靠限制未知大小下载,使用受支持版本再做验证;不要把磁盘空间告警当成大小限制的替代。