Bash脚本debug.sh输出管道堵塞 后续jq处理无输出该如何解决

问题根因 #

• 核心是jq的默认缓冲策略：当输出目标是交互式终端时，jq默认使用行缓冲，内容实时输出；当输出目标是管道/文件时，jq默认启用全缓冲，需要等缓冲区填满（通常为4~8KB）才会批量输出内容，这就是你直接执行脚本有输出、管道二次处理无输出的原因。
• 额外提示：你原脚本的shebang写反了，应该是#!/bin/sh而非!#/bin/sh，部分系统下错误的shebang会导致脚本执行异常。

解决方案 #

方案1：最简适配（保留原有脚本逻辑，仅加缓冲参数） #

直接给脚本内的jq添加--unbuffered参数，强制关闭全缓冲，实时输出内容：

#!/bin/sh

go run server.go 2>&1 | jq --unbuffered -Rr '. as $raw | try fromjson catch $raw'

修改后即可直接执行./debug.sh | jq -r ".message"正常获取输出。

方案2：易用性优化（自动适配终端/管道场景） #

如果希望脚本同时兼顾「直接执行看美化输出」和「管道传输给后续工具处理」两种场景，不需要每次手动调整参数，可以添加终端判断逻辑：

#!/bin/sh

# 判断标准输出是否为交互式终端
if [ -t 1 ]; then
    # 终端场景：输出美化后的格式化JSON，同时兼容非JSON的panic等异常内容
    go run server.go 2>&1 | jq --unbuffered -Rr '. as $raw | try fromjson catch $raw'
else
    # 管道/重定向场景：直接输出原始内容，减少性能损耗，方便后续工具处理
    stdbuf -oL -eL go run server.go 2>&1
fi

该方案下：

• 直接执行./debug.sh：输出和之前完全一致的美化JSON格式日志，异常内容也可以正常捕获展示
• 执行./debug.sh | jq -r ".message"：直接输出原始内容给后续jq处理，无缓冲延迟

额外兼容说明 #

如果修改后仍存在输出延迟，可在go run前添加stdbuf -oL -eL强制Go程序的标准输出、标准错误使用行缓冲，避免Go侧的缓冲阻塞输出。

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