调用Yandex.Cloud函数API时curl传入二进制内容报错的解决方案

你的问题核心是bash命令行参数长度限制——当把大体积zip包的base64编码内容直接拼到curl命令行中时，总参数长度超过了系统允许的上限，就会触发这个错误。另外用xxd -b转base64是多余的，直接用base64命令更高效。下面是几种可靠的解决方法：

方法1：用jq直接构造包含base64内容的JSON（推荐） #

jq可以直接读取文件并转换为base64编码，避免将大内容存入shell变量或命令行参数，同时自动处理JSON格式的转义问题：

curl -X POST "https://functions.api.yandexcloud.net/functions/<你的函数ID>/versions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的授权Token>" \
  -d "$(jq -n \
    --arg runtime "python311"  # 替换为你的运行时环境
    --arg entrypoint "main.handler"  # 替换为你的入口函数
    '{
      runtime: $runtime,
      entrypoint: $entrypoint,
      content: $("你的部署包路径.zip" | @base64)
    }')"

方法2：用临时文件存储请求体 #

如果不想用jq，可以先将JSON模板和base64内容合并到临时文件，再让curl读取该文件：

1. 创建JSON模板文件request_template.json：

{
  "runtime": "python311",
  "entrypoint": "main.handler",
  "content": "{{BASE64_CONTENT}}"
}

2. 生成base64内容并替换模板占位符：

# 生成无换行的base64编码
base64 -w 0 你的部署包路径.zip > temp_base64.txt
# 替换模板中的占位符，生成最终请求体
sed "s/{{BASE64_CONTENT}}/$(cat temp_base64.txt)/" request_template.json > temp_request.json

3. 用curl发送请求：

curl -X POST "https://functions.api.yandexcloud.net/functions/<你的函数ID>/versions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的授权Token>" \
  -d @temp_request.json

4. 清理临时文件：

rm temp_base64.txt temp_request.json

方法3：用Heredoc传递请求体 #

如果不想生成临时文件，可以用bash的Heredoc直接将内容传递给curl，但注意如果base64内容过大，存入shell变量仍可能触发长度限制，适合较小的部署包：

# 生成无换行的base64编码
base64_content=$(base64 -w 0 你的部署包路径.zip)

curl -X POST "https://functions.api.yandexcloud.net/functions/<你的函数ID>/versions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的授权Token>" \
  --data-binary @- <<EOF
{
  "runtime": "python311",
  "entrypoint": "main.handler",
  "content": "$base64_content"
}
EOF

关键注意点 #

• 必须用base64 -w 0生成无换行的base64字符串，否则JSON解析会失败。
• 避免将超大内容直接放入shell变量或curl命令行参数，这是触发"Argument list too long"的根本原因。

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