配置加载失败却退出码 0：#!/usr/bin/env bash 的两级 PATH 解析导致 4 份配置一份没生效

$ bash ops/start_taskctl.sh
[taskctl] PATH=/opt/hooks:/srv/site/bin
[taskctl] NOTIFIER_CMD=notifier
[taskctl] 配置加载器: 10-base.conf 有问题（/usr/bin/env: ‘bash’: No such file or directory），已跳过
[taskctl] 配置加载器: 20-tuned.conf 有问题（/usr/bin/env: ‘bash’: No such file or directory），已跳过
[taskctl] 配置加载器: 30-legacy.conf 有问题（/usr/bin/env: ‘bash’: No such file or directory），已跳过
[taskctl] 配置加载器: 40-bom.conf 有问题（/usr/bin/env: ‘bash’: No such file or directory），已跳过
[taskctl] 配置加载器: 完成（4 个问题，0 个已导入）
[taskctl] 主循环: 就绪
$ echo $?
0

git fetch origin
git checkout 2026-09-21-0800
cd scenario/2026-09-21-0800
docker compose up -d --build

docker compose exec app bash ops/repro.sh     # 一键看症状
docker compose exec app bash ops/verify.sh    # 问题态 PASS=5 FAIL=12
docker compose exec app bash ops/accept.sh    # RESULT: BAD

# ① 同一份带 shebang 的配置，只差一个 PATH，两台机器两种结局
printf '#!/usr/bin/env bash\nMODE=canary\n' > /tmp/a.conf && chmod 755 /tmp/a.conf
PATH="/usr/local/sbin:/usr/bin:/bin" /tmp/a.conf   # rc=0
PATH="/opt/hooks:/srv/site/bin"      /tmp/a.conf   # rc=127
#   /usr/bin/env: 'bash': No such file or directory

# ② execvp 只在 PATH 里找：绝对路径 /usr/bin/env 存在也没用
python3 -c "
import subprocess, os
print('/usr/bin/env 存在:', os.path.exists('/usr/bin/env'))   # True
subprocess.run(['env','--version'], env={'PATH':'/opt/hooks'})"
# FileNotFoundError: [Errno 2] No such file or directory: 'env'

内核 execve("/srv/conf/20-tuned.conf")
  → 读到 shebang "#!/usr/bin/env bash"
  → 按【当前进程的 PATH】找 "env"        ← 第 1 级；PATH 没 /usr/bin 就 127
  → 执行 env，env 再按【同一份 PATH】找 "bash" ← 第 2 级；PATH 没 /bin 也 127

subprocess.run(["/usr/bin/env", "bash", "-c", '. "$1"; { %s; }' % PROBE, "loadcfg", path], ...)
#              ^^^^^^^^^^^^^^^ 写死的绝对路径，实际仍按 PATH 解析

if r["stderr"] or r["rc"] != 0:
    result["problems"] += 1
    log(f"配置加载器: {name} 有问题（{first}），已跳过")     # ← 只 WARN，不进 fatal

head -c 16 /srv/conf/40-bom.conf | od -An -tx1z
#  ef bb bf 4d 4f 44 45 =3d ...      ← UTF-8 BOM
bash -c '. /srv/conf/40-bom.conf'
# /srv/conf/40-bom.conf: line 1: $'\357\273\277MODE=bommed': command not found

head -c 20 /srv/conf/30-legacy.conf | od -c
#   M O D E = l e g a c y \r \n        ← CRLF，值尾随 \r

grep -c 'loader.env' ops/start_taskctl.sh   # 0

export PATH="/opt/hooks:/srv/site/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
if [ -f /scenario/conf/loader.env ]; then
  . /scenario/conf/loader.env     # 契约必须真的被读进来
  echo "[wrapper] 已加载部署契约 conf/loader.env（LOADER_STRICT=${LOADER_STRICT:-未设置}）"
fi
PY_BIN="$(command -v python3 || echo /usr/bin/python3)"
exec "$PY_BIN" /scenario/app/taskctl.py

def resolve_interpreter() -> tuple[str, str]:
    found = shutil.which("bash")
    if found:
        return found, "PATH"
    for cand in ("/bin/bash", "/usr/bin/bash", "/usr/local/bin/bash", "/bin/sh"):
        if os.path.exists(cand):
            return cand, "absolute-fallback"
    raise RuntimeError("PATH 与已知绝对路径里都找不到 bash，无法加载配置")

def normalize_config(path: str) -> str:
    with open(path, "rb") as f:
        raw = f.read()
    if raw.startswith(b"\xef\xbb\xbf"):
        raw = raw[3:]                      # 剥 BOM
    return raw.decode("utf-8", errors="replace").replace("\r\n", "\n").replace("\r", "\n")

def load_one(bash: str, text: str) -> dict:
    return subprocess.run(
        [bash, "-c", '. /dev/stdin; { %s; }' % PROBE],   # 显式 source，不看 shebang / 不看 x 位
        input=text, capture_output=True, text=True, env=os.environ)

$ docker compose exec app bash ops/start_taskctl.sh
[wrapper] 已加载部署契约 conf/loader.env（LOADER_STRICT=1）
[taskctl] 配置解释器: /usr/bin/bash（来源：PATH）
[taskctl]     [10-base.conf] MODE=normal
[taskctl]     [20-tuned.conf] MODE=canary-tuned
[taskctl]     [30-legacy.conf] MODE=legacy
[taskctl]     [40-bom.conf] MODE=bommed
[taskctl] 配置加载器: 完成（0 个问题，4 个已导入）
[taskctl] notifier 命中：/opt/hooks/notifier
[taskctl] 自检通过：MODE=bommed UPSTREAM=db-04.internal:5432 notifier=/opt/hooks/notifier
[taskctl] 主循环: 就绪

# hook 缺失 → 必须启动失败
mv /opt/hooks/notifier /opt/hooks/notifier.bak
bash ops/start_taskctl.sh; echo $?      # 4，并明确说「PATH 里找不到 notifier」

# 真坏一个配置 → 必须拒绝启动
printf 'MODE=normal\nexit 7\n' > /srv/conf/10-base.conf
bash ops/start_taskctl.sh; echo $?      # 3，并列出 failed=['10-base.conf']

# 还原问题态 → 立刻回落
rm -f /tmp/taskctl-selfcheck.json; bash ops/verify.sh | tail -3   # PASS=5 FAIL=12