精准捕捉 Shell 函数并发失败的关键是让每个函数独立报告状态：分配唯一任务名、立即捕获 $?、写入结构化日志，用临时文件隔离上下文，辅以失败通知文件实时中断，并按 ID 汇总归因。
在并发执行多个 Shell 函数任务时，精准捕捉某个具体失败节点，关键不在于“事后排查”，而在于**让每个函数独立报告自身状态，并确保状态不被覆盖、不被混淆**。Shell 本身没有内置的异常对象或堆栈跟踪，所以必须靠显式设计来实现“可追溯的失败定位”。
每个函数单独封装状态输出
不要依赖全局变量或共享日志混写——容易错乱。推荐为每个函数分配唯一标识（如任务名、序号），并强制它在退出前写入结构化状态记录：
- 用函数名或传入参数作为 ID，例如 task_name="backup_db_20260720"
- 函数末尾统一写入：echo "[$task_name] status: $?" >> /tmp/task_status.log
- 避免用
$?隔行读取——必须紧跟命令后立刻捕获，否则会被下一条命令覆盖
用临时文件隔离执行上下文
函数在后台运行时，子 shell 会丢失父进程变量。直接传参 + 写入专属日志更可靠：
- 启动时生成唯一日志路径：log="/tmp/${task_name}_$$.log"（
$$是当前 shell PID） - 函数内所有输出重定向到该文件：exec > "$log" 2>&1
- 最后追加状态：echo "exit_code: $?" >> "$log"
- 主脚本通过解析各日志文件，就能一一对应到哪个函数、哪次调用失败
用命名管道或文件锁辅助同步标记
当需要实时感知失败（比如一失败就中止其余任务），可用轻量级信号机制：
- 定义一个失败通知文件：FAIL_NOTIFY="/tmp/.fail_flag"
- 任一函数失败时执行：echo "$task_name" > "$FAIL_NOTIFY" && exit 1
- 主循环中定期检查：if [ -s "$FAIL_NOTIFY" ]; then failed_task=$(cat "$FAIL_NOTIFY"); echo "中断：$failed_task 失败"; break; fi
- 注意：需配合
trap 'rm -f $FAIL_NOTIFY' EXIT清理
汇总阶段按 ID 匹配结果
所有任务结束后，不再靠顺序或时间猜哪个失败，而是按 ID 精准归因：
- 遍历所有日志：for log in /tmp/*_$$*.log; do task=$(basename "$log" | sed 's/_.*.log//'); status=$(grep -oP 'exit_code: \K\d+' "$log" 2>/dev/null); ...
- 状态码为非 0 时，直接打印对应 $task 和完整日志路径，便于复现
- 可进一步提取错误行：tail -n 20 "$log" | grep -E "(error|failed|Exception)"
