Продвинутое Bash-программирование: лучшие практики обработки ошибок

Обработка ошибок в Bash-скриптах — это то, что превращает небольшую ошибку автоматизации в серьезную производственную проблему. Если резервное копирование не удалось, вызов API вернул ошибку или временный файл остался, ваш скрипт должен четко остановиться и оставить систему в известном состоянии.

Используйте эти шаблоны, когда ваш скрипт изменяет файлы, развертывает код, взаимодействует с удаленными сервисами или выполняется без наблюдения за терминалом.

Основа: понимание кодов выхода

Каждая команда, выполненная в Bash, независимо от успеха или неудачи, возвращает статус выхода (или код выхода). Это фундаментальный механизм для сигнализации о результатах команды.

• Код выхода 0: Указывает на успешное выполнение. По соглашению ноль означает успех.
• Коды выхода 1–255 (ненулевые): Указывают на ошибку, сбой или предупреждение. Конкретные ненулевые коды часто обозначают определенные типы ошибок (например, 1 обычно означает общую ошибку, 2 часто означает неправильное использование команды оболочки).

Последний статус выхода хранится в специальной переменной $?.

# Успешная команда
ls /tmp
echo "Статус: $?"
# Статус: 0

# Неудачная команда (несуществующий файл)
cat /nonexistent_file
echo "Статус: $?"
# Статус: 1 (или выше, в зависимости от ошибки)

Обязательная лучшая практика: внедрение строгого режима

Для любого серьезного Bash-скрипта три директивы должны быть размещены сразу после строки shebang. В совокупности их часто называют «строгим режимом». Они заставляют скрипт завершаться раньше, вместо того чтобы продолжать после нарушенного предусловия.

1. Немедленный выход при ошибке (set -e)

Команда set -e или set -o errexit указывает Bash немедленно завершить скрипт, если любая команда завершится с ненулевым статусом. Это предотвращает каскадные сбои.

Предупреждение: set -e игнорируется в условных проверках (if, while) или если команда является частью списка && или ||. Статус сбоя должен быть явно использован окружающей структурой.

2. Обработка неустановленных переменных как ошибок (set -u)

Команда set -u или set -o nounset заставляет скрипт немедленно завершиться, если он пытается использовать переменную, которая не была установлена (например, опечатка $FIELNAME вместо $FILENAME). Это предотвращает трудноотлаживаемые ошибки, возникающие из-за пустых или непреднамеренных переменных.

3. Обработка ошибок в конвейерах (set -o pipefail)

По умолчанию, если серия команд объединена в конвейер (например, cmd1 | cmd2 | cmd3), Bash сообщает только статус выхода последней команды (cmd3). Если cmd1 завершится ошибкой, скрипт может продолжить успешное выполнение.

set -o pipefail гарантирует, что статусом выхода конвейера будет статус выхода последней команды, которая завершилась ошибкой, или ноль, если все команды выполнены успешно. Это критически важно для надежной обработки данных.

Стандартный заголовок строгого режима

Всегда начинайте продвинутые скрипты с этого надежного заголовка:

#!/bin/bash

set -euo pipefail

Некоторые старые шаблоны также устанавливают IFS=$'\n\t'. Используйте это только тогда, когда вы понимаете, как это влияет на разделение слов в остальной части скрипта. Обычно более понятным является заключение переменных в кавычки и чтение ввода с помощью while IFS= read -r line.

Условная проверка ошибок

Хотя set -e обрабатывает неожиданные ошибки, часто необходимо проверять конкретные условия или предоставлять пользовательские сообщения об ошибках.

Использование операторов if и пользовательских функций

Вместо того чтобы полагаться исключительно на set -e, используйте блоки if для корректной обработки известных потенциальных сбоев и предоставления описательного вывода.

# Определите пользовательскую функцию ошибки для единообразия
error_exit() {
    printf '[ФАТАЛЬНО] %s\n' "$1" >&2
    exit 1
}

TEMP_DIR="/tmp/data_processing_$(date +%s)"

# Проверьте, успешно ли создание каталога
if ! mkdir -p "$TEMP_DIR"; then
    error_exit "Не удалось создать временный каталог: $TEMP_DIR"
fi

echo "Временный каталог успешно создан: $TEMP_DIR"

# Пример проверки существования файла перед обработкой
FILE_TO_PROCESS="input.csv"

if [[ ! -f "$FILE_TO_PROCESS" ]]; then
    error_exit "Входной файл не найден: $FILE_TO_PROCESS"
fi

Логика короткого замыкания (&& и ||)

Для простых последовательных операций используйте операторы короткого замыкания. Это очень читаемо и лаконично.

• Цепочка успеха (&&): Вторая команда выполняется только в случае успеха первой.
• Перехват ошибки (||): Вторая команда выполняется только в случае сбоя первой.

# Выполните настройку, а затем обработку, завершившись ошибкой, если настройка не удалась
setup_environment && process_data

# Попробуйте подключиться, иначе корректно завершите работу с сообщением
ssh user@server || { echo "Не удалось подключиться, проверьте настройки сети." >&2; exit 2; }

Корректное завершение и очистка с помощью trap

Команда trap позволяет скрипту перехватывать сигналы (например, Ctrl+C, завершение системы или выход из скрипта) и выполнять указанную команду или функцию перед завершением. Это необходимо для задач очистки.

Функция cleanup

Определите выделенную функцию для отмены любых изменений (например, удаление временных файлов, сброс конфигураций) и используйте trap, чтобы гарантировать ее выполнение независимо от того, как завершится скрипт.

# Глобальная переменная для проверки функцией очистки
TEMP_FILE=""

cleanup() {
    printf '%s\n' "--- Выполнение процедур очистки ---"
    if [[ -f "$TEMP_FILE" ]]; then
        rm -f "$TEMP_FILE"
        echo "Удален временный файл: $TEMP_FILE"
    fi
    # При необходимости предоставьте отчет о конечном статусе выхода
}

# 1. Перехват EXIT: запускает очистку независимо от успеха, сбоя или сигнала.
trap cleanup EXIT

# 2. Перехват сигналов (INT=Ctrl+C, TERM=сигнал завершения)
trap 'printf "%s\n" "Скрипт прерван пользователем или системным сигналом." >&2; exit 130' INT
trap 'printf "%s\n" "Скрипт завершен." >&2; exit 143' TERM

# --- Основная логика скрипта ---
TEMP_FILE=$(mktemp)
echo "Временное содержимое" > "$TEMP_FILE"
# Если скрипт завершится ошибкой или будет прерван здесь, cleanup() гарантированно выполнится

Зачем использовать trap cleanup EXIT?

Установка trap на EXIT гарантирует, что функция очистки выполнится независимо от того, завершится ли скрипт нормально (exit 0), явно завершится с ошибкой (exit 1) или будет принудительно завершен из-за set -e.

Продвинутая отчетность об ошибках

Стандартные сообщения об ошибках (команда не найдена) часто лишены контекста. Продвинутые скрипты должны сообщать что не удалось, где это произошло и почему.

Логирование номеров строк

Когда вызывается такая функция, как error_exit, вы можете определить номер строки в скрипте, где произошла ошибка, используя массив BASH_LINENO или команду caller (хотя caller часто ограничен функциями).

Для простой отчетности вне функций используйте переменную LINENO:

# Пример немедленной отчетности об ошибке
(some_risky_command) || {
    echo "[ОШИБКА $LINENO] some_risky_command завершилась с кодом $?" >&2
    exit 3
}

Различие вывода

Всегда отправляйте информационные сообщения в стандартный вывод (stdout), а сообщения об ошибках/предупреждениях — в стандартный вывод ошибок (stderr). Это критически важно, если вывод вашего скрипта передается по конвейеру другой программе или регистрируется внешне.

• echo "Информационное сообщение" (идет в stdout)
• echo "[ПРЕДУПРЕЖДЕНИЕ] Переопределение конфигурации" >&2 (идет в stderr)

Соберите шаблон вместе

Для большинства производственных скриптов практический шаблон прост: начните с set -euo pipefail, проверяйте входные данные перед выполнением работы, оборачивайте ожидаемые сбои в if ! command; then ...; fi и добавьте trap cleanup EXIT перед созданием временного состояния.

Это дает полезные сбои вместо загадочных. В следующий раз, когда задание сломается в 2 часа ночи, журнал должен показать, что не удалось, где искать и выполнялась ли очистка.