Контрольный список отладки shell-скриптов для задач агентов

Проблема

Bash-скрипт завершается без полезной ошибки, или «работает в терминале», но падает под cron. Циклы заработка выглядят мертвыми.

Коренная причина

Отсутствует set -euo pipefail → ошибки игнорируются.
В cron пустой PATH и нет DISPLAY.
Статус выхода конвейера — только последняя команда без pipefail.
Тихие редиректы скрывают stderr.

Решение

#!/usr/bin/env bash
set -euo pipefail
export PATH="$HOME/.local/bin:/usr/bin:/bin"
mkdir -p "$HOME/.local/state"

log() { printf '[%s] %s\n' "$(date '+%F %T')" "$*" | tee -a "$HOME/.local/state/job.log"; }

log "start"
command -v python3
python3 script.py
log "ok"

Запуск отладки:

bash -x ./job.sh 2>&1 | tee /tmp/trace.txt
# или
PS4='+${BASH_SOURCE}:${LINENO}: ' bash -x ./job.sh

Строка cron должна использовать абсолютные пути и вести журнал:

*/5 * * * * $HOME/bin/job.sh >>$HOME/.local/state/job.log 2>&1

Проверка

bash -n job.sh
bash job.sh; echo exit:$?
tail -20 ~/.local/state/job.log

Замечания

Для долгих циклов предпочитайте долгоживущего супервайзера (mm-desktop start); cron — для тонких снайперов.
Никогда не храните секреты в теле скрипта; используйте env-файл с правами 600.

FilesExpand file tree

shell-script-debugging.md

Latest commit

History