Bash 错误处理:验证复制、清理临时文件与禁止覆盖
更可靠的文件脚本应先验证输入与目标,明确处理每一步失败,并避免把未完成的中间结果当作成功结果。不要只依赖 set -e:应分别设计失败分支、临时文件清理和禁止覆盖的条件。
本节在第一个 Bash 脚本的基础上处理文件复制失败;&&、|| 和管道的执行规则可参考Shell 执行流程。
先限定示例能处理的环境
下面只在自己控制的可信目录内,把一个普通文件复制为新名字并比较内容。目标的父目录必须已存在,且不能被不可信用户修改。不要以管理员身份执行,也不要把它当作抵御恶意路径替换的安全边界或数据库备份工具。复制期间源文件应保持不变。
需要 Bash、GNU coreutils 的 cp、ln、mktemp、dirname、rm、rmdir,以及 cmp 和 find。GNU ln 的 -T 在其他实现中可能不可用,应先检查工具。本例适合支持同一文件系统内硬链接的 Linux 实验环境;不满足条件时让操作失败,不要随意换成会覆盖文件的命令。
把检查、临时复制和目标创建分开
在一个专用 Bash 练习会话逐步执行下面的准备命令,并创建完整脚本。临时目录创建或切换失败会结束该会话;先保存其他工作。准备过程任何一步报错都应停止。脚本以 LF 换行保存;带引号的 EOF 使块内变量原样写入脚本,结束标记独占一行。
lab=$(mktemp -d "$HOME/linux-safe-copy.XXXXXX") || exit 1
cd "$lab" || exit 1
mkdir output
printf "important sample\n" > "source file.txt"
cat > checked-copy.sh <<'EOF'
#!/usr/bin/env bash
set -u
set -o pipefail
umask 077
if (( $# != 2 )); then
printf "Usage: %s SOURCE DESTINATION\n" "$0" >&2
exit 2
fi
source_file=$1
destination=$2
if [[ ! -f "$source_file" || -L "$source_file" ]]; then
printf "Source must be a regular non-symlink file\n" >&2
exit 1
fi
if [[ -e "$destination" || -L "$destination" ]]; then
printf "Destination already exists\n" >&2
exit 1
fi
parent=$(dirname -- "$destination") || exit 1
if [[ ! -d "$parent" ]]; then
printf "Destination directory is missing\n" >&2
exit 1
fi
work=$(mktemp -d "$parent/.copy-work.XXXXXX") || exit 1
cleanup() { rm -f -- "$work/payload"; rmdir -- "$work"; }
trap cleanup EXIT
trap 'exit 130' INT
trap 'exit 143' TERM
if ! cp -- "$source_file" "$work/payload"; then
printf "Copy failed\n" >&2
exit 1
fi
if ! cmp -s -- "$source_file" "$work/payload"; then
printf "Verification failed\n" >&2
exit 1
fi
if ! ln -T -- "$work/payload" "$destination"; then
printf "Destination creation failed\n" >&2
exit 1
fi
printf "Created: %s\n" "$destination"
EOF
bash -n checked-copy.sh
bash checked-copy.sh "source file.txt" "output/copy file.txt"
cmp "source file.txt" "output/copy file.txt"
正常执行预期显示 Created: output/copy file.txt;最后的 cmp 应无输出且状态为 0。set -u 检查未设置的变量,umask 077 限制新对象默认权限,但都不能替代对父目录和访问控制的核对。
脚本拒绝符号链接源文件,并把已经存在或是悬空符号链接的目标视为错误。随后在目标父目录内创建唯一工作目录,先 cp 到 payload,再用 cmp 比较。cmp -s 静默比较:内容相同为 0,不同为 1,读取等问题为 2;本脚本将后两种情况都作为验证失败。
临时文件与目标位于同一文件系统,ln -T 最后创建目标硬链接,不使用覆盖选项。-T 强制把目标当作一个名字,避免检查后目标变成目录时,ln 转而在该目录内创建链接。这个改进仍不能防御父路径被恶意替换或其他并发竞争;可信、稳定的目录是前提。
EXIT 清理删除工作目录内唯一预期的 payload 名字,再用 rmdir 删除空工作目录;目标硬链接仍引用相同数据。这里不递归删除未知内容,也不对用户输入的源路径或目标路径执行删除。若目录出现意外内容或删除失败,会保留错误信息,不能无条件认为清理已经完成。
内容比较不保证所有权、访问控制列表(ACL)、扩展属性或断电后的物理持久性。它也不能保证复制期间不断变化的源文件形成一致快照。即使显示 Created,仍需按业务要求验证数据和清理状态。
实际改变失败条件并检查原文件
bash checked-copy.sh "source file.txt" "output/copy file.txt"
printf "exit=%s\n" "$?"
bash checked-copy.sh missing.txt output/new.txt
printf "exit=%s\n" "$?"
find output -maxdepth 1 -name ".copy-work.*" -print
第一条重复创建已有目标,预期退出状态 1,并保留先前副本;第二次使用不存在的源文件,也应失败。两条 printf 必须紧接着对应命令,才能读取该命令的 $?。最后的 find 在普通成功或已处理失败后,预期不显示工作目录;若仍有路径,先检查原因和所属实验,不要批量清理陌生目录。
测试后再用 cmp "source file.txt" "output/copy file.txt" 确认原文件和首次副本仍一致。还可用缺少参数、缺少目标父目录等输入分别检查错误分支。INT 和 TERM 的处理分别请求以 130、143 退出,并触发 EXIT 清理;SIGKILL 或断电无法运行 trap,需要另行处理遗留数据。信号测试应在独立测试进程进行。
理解 set -e 与 pipefail 的边界
bash -c 'false | cat; printf "status=%s\n" "$?"'
bash -o pipefail -c 'false | cat; printf "status=%s\n" "$?"'
第一条通常显示 status=0,因为管道最后的 cat 成功;第二条启用 pipefail,显示 status=1。pipefail 让管道返回最右侧非零组件的状态,并不会自动恢复失败。这里紧接着的 printf 本身通常成功,所以最外层 Bash 的最终退出状态仍可能为 0;显示的管道状态和整个命令最终状态要分开理解。
set -e 的退出规则在 if 测试、&&/|| 列表和管道等上下文中有例外。不能把它当作统一的异常机制,必须测试实际调用上下文。本例对关键复制、比较和链接操作写出显式分支。
if ! command; then 适合进入失败分支,但其中的 $? 是逻辑取反后的状态,不是原始错误码。需要保留原始状态时,在 else 分支第一时间写 rc=$?,例如 if command; then ...; else rc=$?; ...; fi。调用者也应能够根据返回码及错误消息区分失败原因。
用于自动化前核对操作前提
- 给变量展开加引号,在支持的命令中用
--分隔选项与文件名。 - 把预览与实际修改分开,确认预览确实不会修改数据。
- 核对目录所有权、权限、符号链接、并发执行和源数据变化。
- 分别测试成功、各失败分支及可处理信号,保留可恢复的备份。




