Singularity容器Bash脚本出现‘Bad substitution’错误的排查与解决

嘿，我碰到过一模一样的问题！咱们来拆解一下为啥这段Bash代码在Singularity的%post段里会报错，以及怎么搞定它。

问题根源 #

Singularity的%post脚本默认是用/bin/sh执行的，而不是/bin/bash！你写的${VAR: -1}（取最后一个字符）和${VAR%?}（删除最后一个字符）这些是Bash特有的参数扩展语法，POSIX标准的sh完全不支持，这就是为啥会抛出Bad substitution错误。

你本地测试的时候用的是bash，所以运行正常，但容器构建时%post用的是sh，自然就“炸锅”了。另外还要提一句：你示例里的$SINGULAITY_ROOTFS拼写错了，应该是$SINGULARITY_ROOTFS，这个小错误也会导致路径找不到，得一起改了~

解决方法 #

有两种靠谱的方式来修复这个问题：

方法1：强制%post用bash执行 #

最简单的办法就是在%post段的最开头加上#!/bin/bash，告诉Singularity用bash来跑这段脚本，这样就能支持所有Bash的语法了。修改你的def文件里的%post部分：

%post
#!/bin/bash
# 设置输出颜色
GREEN='\033[0;32m' NOCOLOUR='\033[0m'
# 开始执行
echo "${GREEN}~~~ 赋予用户权限与控制权 ~~~ ${NOCOLOUR}"
umask 000
echo "${GREEN}~~~ 这段代码应该可以正常运行！~~~ ${NOCOLOUR}"
MYSCRIPT=$SINGULARITY_ROOTFS/confuzzel
touch $MYSCRIPT
chmod u+x $MYSCRIPT
echo '#! /bin/bash' >> $MYSCRIPT
echo 'PATHY="/what/a/path/"' >> $MYSCRIPT
echo 'if [ "${PATHY: -1}" = "/" ]; then ' >> $MYSCRIPT
echo ' echo yay!' >> $MYSCRIPT
echo ' PATHY="${PATHY%?}"' >> $MYSCRIPT
echo 'fi' >> $MYSCRIPT
echo 'echo $PATHY' >> $MYSCRIPT
cat $MYSCRIPT
./confuzzel

方法2：改用POSIX兼容的语法 #

如果你不想依赖bash，想要更好的兼容性，也可以把代码改成sh支持的写法。比如：

• 检查最后一个字符是否为/并去除的逻辑，可以用case语句：

PATHY="/what/a/path/"
# POSIX兼容的末尾斜杠处理
case "$PATHY" in
    */) PATHY="${PATHY%/}" ;;  # 这里的${VAR%/}是POSIX支持的，比${VAR%?}更精准
esac
echo $PATHY

或者用sed命令来实现：

PATHY=$(echo "$PATHY" | sed 's/\/$//')

这种写法在sh和bash环境下都能正常运行，兼容性拉满。

验证修改后的效果 #

把def文件改好之后，重新执行构建命令：

sudo singularity build badSubs.sif badSubs.def

这次构建过程中，脚本就能正常执行，不会再出现Bad substitution的错误啦。

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