Bash：变量插入curl调用失效问题排查

我之前也碰到过一模一样的情况——变量能正常echo输出，但API就是不认，核心原因几乎都是POST请求的参数传递格式不符合API的要求，毕竟提取逻辑已经验证没问题了。下面给你拆解可能的问题和对应的解决方案：

1. 你可能没正确指定参数的传递方式 #

很多API会要求参数以表单（application/x-www-form-urlencoded）或JSON格式传递，如果你只是把变量直接跟在curl命令后面，API根本识别不到哪个参数对应哪个字段。

示例：表单格式传递 #

如果API期望接收表单参数（比如item是参数名），修改你的curl命令：

# 提取提交信息（假设你的原命令逻辑是这样）
commit_content=$(git log -1 --pretty=format:"%s" | cut -d' ' -f2-)
# 用-d指定表单参数，用引号包裹变量避免空格拆分参数
curl -X POST -d "item=$commit_content" https://your-api-endpoint.com/target
# 验证
echo "$commit_content"

示例：JSON格式传递 #

如果API要求JSON格式，记得加上Content-Type头，还要对变量里的特殊字符（比如引号、换行）做转义：

commit_content=$(git log -1 --pretty=format:"%s" | cut -d' ' -f2-)
# 用jq工具对字符串做JSON转义（需要先安装jq）
escaped_content=$(echo "$commit_content" | jq -R .)
# 构造JSON请求体并发送
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"item":'"$escaped_content"'}' \
  https://your-api-endpoint.com/target
echo "$commit_content"

2. 变量里的特殊字符导致参数被截断 #

git提交信息里可能包含空格、双引号、换行符这些字符，直接传递的话会被shell解析成多个参数，导致API只接收到部分内容。上面的示例里用引号包裹变量（表单场景）或jq转义（JSON场景）就能解决这个问题。

调试技巧 #

如果还是不确定问题在哪，给curl加-v参数查看请求详情：

curl -v -X POST -d "item=$commit_content" https://your-api-endpoint.com/target

看输出里的Request Body部分，确认发送的内容和你echo的是否完全一致——这能快速定位是不是参数传递过程中出了问题。

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