Shell脚本调用curl：命令行参数传入用户名失败问题排查

问题核心原因 #

1. 单引号导致变量未解析：你用单引号包裹整个URL时，Shell不会解析单引号内的${username}变量，实际发送的请求里principal参数的值是字符串${username}，而非传入的真实用户名，这是请求失败的主要原因。
2. URL编码潜在问题：用户名中的@符号虽属URL合法字符，但部分身份提供商可能要求严格编码（@需转为%40），也可能导致用户识别失败。

修复方案 #

方案1：修正变量解析（基础解决） #

把包裹URL的单引号改为双引号，或通过引号拼接让变量被正确解析：

username="$1"
# 方式1：用双引号包裹整个URL
curl -k "https://test01.foo.com:4487/profile/admin/test?requester=https://saml.example.org&principal=${username}&saml2"

# 方式2：单引号+双引号拼接
curl -k 'https://test01.foo.com:4487/profile/admin/test?requester=https://saml.example.org&principal='"${username}"'&saml2'

方案2：添加URL编码（推荐） #

为避免特殊字符（如@、空格、&等）引发的兼容问题，对用户名做URL编码后再传入：

username="$1"
# 用curl自带功能完成URL编码
encoded_username=$(curl -Gso /dev/null -w %{url_effective} --data-urlencode "principal=${username}" "" | cut -d'=' -f2)
curl -k "https://test01.foo.com:4487/profile/admin/test?requester=https://saml.example.org&principal=${encoded_username}&saml2"

也可以用printf实现编码：

username="$1"
encoded_username=$(printf "%s" "$username" | xxd -plain | tr -d '\n' | sed 's/\(..\)/%\1/g')
curl -k "https://test01.foo.com:4487/profile/admin/test?requester=https://saml.example.org&principal=${encoded_username}&saml2"

验证技巧 #

执行脚本时传入用户名参数，比如：

./your_script.sh jim@foo.com

可先添加echo命令查看生成的curl命令，确认参数是否正确：

username="$1"
encoded_username=$(curl -Gso /dev/null -w %{url_effective} --data-urlencode "principal=${username}" "" | cut -d'=' -f2)
# 先打印命令确认
echo curl -k "https://test01.foo.com:4487/profile/admin/test?requester=https://saml.example.org&principal=${encoded_username}&saml2"
# 确认无误后再执行curl
# curl -k "https://test01.foo.com:4487/profile/admin/test?requester=https://saml.example.org&principal=${encoded_username}&saml2"

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