Bash cat file | while read 管道里变量丢失：total 计数总是 0（子 shell 作用域陷阱）

日期：2026-09-04 ｜ 环境：Linux + Bash ｜ 技术栈：shell 脚本、管道、子 shell、变量作用域、while read

一、问题背景

写了一个运维脚本 count_errors.sh 统计一批日志文件中的 ERROR 行数。思路是用 cat "$logfile" | while read -r line; do ... done 逐行读每个日志文件，命中 ERROR 就把计数器 total 加一，最后输出总数。

现象：脚本运行时，发现 ERROR: xxx 的行确实被逐行打印出来了，但每个文件的统计结果和最终总数始终是 0——即使 3 个日志文件里明明有 8 条 ERROR。

二、复现步骤

cd scenario/2026-09-04-0000
docker compose up -d --build
docker compose exec app bash

# 直接运行问题脚本
bash count_errors.sh
# 输出：ERROR 行打印出来了，但 "总计发现 0 条 ERROR 日志"

# 对比：实际日志里的 ERROR 总数
grep -c ERROR logs/*.log   # 3 + 3 + 2 = 8

关键输出（复现成功）：

>>> 检查文件: ./logs/app1.log
  发现 ERROR: ... Database connection timeout ...
   本文件统计结果: 0        ← 明明发现了 ERROR，累计值却是 0！
...
总计发现 0 条 ERROR 日志

三、根本原因

Bash 管道 | 会启动子 shell。 在 cat "$logfile" | while read ... done 结构中，while 循环运行在子 shell 中（管道右侧天然就是子进程）。

子 shell 中对变量的修改（total=$((total + 1))）只作用于子 shell 自己的变量副本。while 循环结束时子 shell 退出，所有修改随之丢失。父 shell 里的 total 从未被改动，依旧是初始值 0。

一句话根因：管道右侧的 while 循环跑在子 shell 里，循环内改的变量传不回父 shell。

典型症状识别：循环体里 echo 能打印出计数（子 shell 里确实改了），但循环结束后父 shell 里变量值没变——这是子 shell 作用域的招牌特征。

四、解决办法

用输入重定向 < 替代管道 |，让 while 循环在当前 shell 中执行：

# 修复前（错误）
cat "$logfile" | while read -r line; do
    total=$((total + 1))
done

# 修复后（正确）
while read -r line; do
    total=$((total + 1))
done < "$logfile"

其他可选方案（任选其一）：

• 进程替换：while read ... done < <(cat "$logfile")
• 子 shell 内输出：把统计和输出都放进子 shell，不往外传
• 直接 grep：grep -c ERROR "$logfile" 逐个文件统计再累加
• awk：awk '/ERROR/{n++} END{print n}' "$logfile"

五、验证

修复后运行脚本输出：

总计发现 8 条 ERROR 日志

与 grep -c ERROR logs/*.log 合计（3+3+2=8）一致，验证通过。

六、经验与避坑

1. 记住铁律：Bash 的 | 会创建子 shell。 不只是 while read，foo | for、foo | { ...; } 等管道右侧的花括号/循环里改变量同样会"丢"。
2. 看到"循环里能打印、循环外变量没变"就要第一时间怀疑子 shell 作用域。
3. 在 while 循环里累积变量时，优先用输入重定向或进程替换，让循环留在当前 shell。
4. 规避姿势：能不用 while 逐行处理就别用。单纯数匹配行数，直接 grep -c 或 awk 更简洁也更不容易踩作用域坑。
5. 排查时可用 echo "$BASHPID" 打印当前 shell PID 验证是否进入了子 shell（管道两侧 PID 会不同）。