Docker中Bash脚本嵌套变量无法展开的问题排查与解决

问题现象 #

在Docker环境的Bash脚本中，执行curl调用${download}变量时，其中的${tmlversion}变量为空（debug3日志显示URL缺失版本号），但调用前的debug2日志明确显示${tmlversion}已经被正确赋值为指定版本。最终导致下载的文件因URL无效无法正常解压。

问题排查与代码对比 #

有问题的代码片段 #

# 先定义包含未赋值变量的URL
download="https://example.com/package-${tmlversion}.tar.gz"
# 后给被引用的变量赋值
tmlversion="1.2.3"

# debug2输出正常：tmlversion=1.2.3
echo "debug2: tmlversion=${tmlversion}"
# debug3输出异常：download=https://example.com/package-.tar.gz
echo "debug3: download=${download}"

curl -O "${download}"

修复后的代码片段 #

# 先给被引用的变量赋值
tmlversion="1.2.3"
# 再定义包含该变量的URL
download="https://example.com/package-${tmlversion}.tar.gz"

# debug2输出正常：tmlversion=1.2.3
echo "debug2: tmlversion=${tmlversion}"
# debug3输出正常：download=https://example.com/package-1.2.3.tar.gz
echo "debug3: download=${download}"

curl -O "${download}"

问题根源 #

Bash的变量展开是在变量定义时完成的，而不是在变量被调用时。如果先定义${download}，此时${tmlversion}还未赋值，展开后就会是空字符串；后续给${tmlversion}赋值不会自动回溯更新已经定义好的${download}变量。

解决方案 #

调整变量定义顺序：先定义被引用的${tmlversion}变量，再定义包含它的${download}变量，确保在构造URL时，${tmlversion}已经有有效值，能被正确展开到URL中。

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