Bash中cURL POST大体积JSON数据时出现exit code 126错误

问题根源 #

exit code 126在bash环境下通常表示命令无法被执行，结合你仅在JSON数据量增大时触发问题的情况，核心原因是：bash命令行参数总长度超过了系统的ARG_MAX限制。当你把大体积JSON直接通过-d "${JSON}"作为命令参数传递时，整个curl命令的长度会突破系统允许的最大命令行参数长度，导致bash无法启动curl进程，返回126错误。

解决方法 #

不要直接在命令行参数中传递JSON内容，改用curl的文件读取方式传递数据，这样不会占用命令行参数长度，完美适配2MB级别的大体积JSON。

具体步骤 #

1. 先将JSON变量内容写入临时文件（避免命令行长度限制，同时规避特殊字符转义问题）：

   printf '%s' "${JSON}" > /tmp/post_payload.json
   

2. 修改curl命令，将-d "${JSON}"替换为-d @/tmp/post_payload.json，其他参数保持不变：

   curl -H "Content-Type: application/json" \
       -H "Accept: application/json" \
       -u "${USER}:${API_KEY}" \
       -o "${LOCATION}${RESPONSE_FILE_NAME}" \
       -d @/tmp/post_payload.json \
       "${SERVER}"
   

3. （可选）传输完成后清理临时文件：

   rm /tmp/post_payload.json
   

关键说明 #

• 这种方式仍然会发送application/json格式的数据，完全符合API的要求，不需要使用--form（你的API不支持该方式也不受影响）。
• 可以通过getconf ARG_MAX命令查看当前系统允许的最大命令行参数长度，验证之前的问题确实是长度超限导致的。

内容的提问来源于stack exchange，提问作者Ian