文档首页/ Huawei Cloud EulerOS/ 常见问题/ 如何解决curl命令报out of memory?
更新时间:2025-12-29 GMT+08:00
分享

如何解决curl命令报out of memory?

现象描述

curl命令在使用--data-binary参数传输大文件 / 大数据时,由于该参数会在发起请求前将指定的全部数据完整加载到内存中,当数据超过一定大小时触发 out of memory。

示例:curl -sS -L -w '%{http_code}' -X PUT --data-binary '@/root/example.tar.gz' -H 'Content-Type: application/octet-stream' 'https://example.com/example'
显示:
curl: option --data-binary: out of memory
curl: try 'curl --help' or 'curl --manual' for more information

问题原因

在curl 7.73版本中新增bugfix“curl: make file2memory use dynbuf”用于将更多的自定义内存重分配功能切换到使用动态缓冲区(dynbuf),以实现统一处理并提高可靠性,在该版本中引入MAX_FILE2MEMORY 并定义为1G,当采用--data-binary传输时,如果读取的数据大小超过1G,则报out of memory错误,在curl 8.10.0版本中设置为16G。

引入此次修改的主要原因在于原有逻辑未对读取到内存的文件大小设置明确上限,当用户通过 --data-binary 提交超大文件(如数 GB 的视频、压缩包)时,curl 会无限制地尝试将文件全部加载到内存,存在系统内存耗尽(OOM)风险。此类场景下,不仅 curl 进程会崩溃,还可能抢占系统核心资源,影响其他服务的运行,尤其在服务器端批量调用 curl 的场景中,风险被进一步放大。

解决方案

传输大文件优先使用-T参数(流式上传,逐块读取文件并发送,无需全量加载到内存)

示例:curl -sS -L -w '%{http_code}' -T '/root/example.tar.gz' -H 'Content-Type: application/octet-stream' 'https://example.com/example'

相关文档