Как отловить ошибку в bash скрипте

Отлов ошибок в bash скриптах: стратегии и практики

Отлов ошибок в bash скриптах — это критически важная практика для создания надежных и устойчивых скриптов. В отличие от многих языков высокого уровня, bash не имеет сложной системы исключений, поэтому ответственность за обработку ошибок лежит на разработчике. Основные подходы включают проверку кодов возврата команд, использование операторов контроля выполнения и трассировки.

Основные методы отлова ошибок

1. Проверка кода возврата ($?)

После выполнения каждой команды bash возвращает код завершения (exit code), где 0 означает успех, а любое другое значение — ошибку. Самый базовый метод — явная проверка после каждой операции.

command
if [ $? -ne 0 ]; then
    echo "Ошибка выполнения command" >&2
    exit 1
fi

2. Использование оператора && и ||

Для более компактной проверки можно использовать логические операторы:

command || { echo "Команда завершилась ошибкой" >&2; exit 1; }

А для цепочек команд:

command1 && command2 || { echo "Ошибка в цепочке команд" >&2; exit 1; }

3. Опция set -e (немедленный выход при ошибке)

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

#!/bin/bash
set -e
dangerous_command  # Если здесь ошибка — скрипт завершится

Внимание: set -e имеет некоторые нюансы (например, не работает в контексте if или while), поэтому часто комбинируется с другими опциями.

4. Опция set -o pipefail

По умолчанию код возврата pipeline определяется последней командой. set -o pipefail меняет это поведение: pipeline вернет ошибку, если любая команда в цепочке завершилась неудачно.

#!/bin/bash
set -e
set -o pipefail
cat файл.txt | grep "pattern" | sort  # Ошибка в cat или grep приведет к выходу

5. Трассировка выполнения с set -x

Для сложных скриптов полезно видеть, что именно выполняется. set -x включает режим трассировки, выводя каждую команду и её аргументы перед выполнением.

#!/bin/bash
set -x
complex_command --option value

Комбинированный подход (рекомендуемый)

В большинстве профессиональных скриптов используется комбинация опций сразу в начале:

#!/bin/bash
set -euo pipefail

# e - exit on error
# u - exit on unset variable (предотвращает использование неопределенных переменных)
# o pipefail - учитывать ошибки в pipeline

Этот набор обеспечивает строгий контроль и предотвращает многие типичные ошибки.

Продвинутые техники

Логирование ошибок

Простого вывода на stderr часто недостаточно. Хорошей практикой является запись в лог-файл с timestamp:

log_error() {
    local message="$1"
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] ERROR: $message" >> /var/log/myscript.log
}

command || log_error "command failed with code $?"

Использование trap для обработки сигналов и cleanup

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

cleanup() {
    echo "Выполняется cleanup..." >&2
    rm -f /tmp/tempfile
}

trap cleanup EXIT  # Вызов cleanup при любом выходе

Пример надежного скрипта

#!/bin/bash
set -euo pipefail

SCRIPT_NAME=$(basename "$0")
LOG_FILE="/var/log/${SCRIPT_NAME}.log"

log_error() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] ERROR: $1" >> "$LOG_FILE"
    echo "$1" >&2
}

main() {
    local input_file="$1"
    
    if [[ ! -f "$input_file" ]]; then
        log_error "Файл $input_file не найден"
        exit 2
    fi
    
    process_data "$input_file" || {
        log_error "Ошибка обработки данных"
        exit 3
    }
}

process_data() {
    local file="$1"
    grep "critical" "$file" | sort > /tmp/output.txt || return 1
    # Дальнейшая обработка...
}

trap "log_error 'Скрипт прерван' exit 1" SIGINT SIGTERM

main "${1:-default.txt}"

Ключевые рекомендации

• Всегда используйте set -euo pipefail для новых скриптов.
• Проверяйте аргументы и состояние системы (существование файлов, доступность команд) перед основной логикой.
• Логируйте ошибки с контекстом (код ошибки, время, аргументы команды).
• Определяйте четкие коды возврата для разных типов ошибок (например, 1 — общая ошибка, 2 — файл не найден, 3 — ошибка сети).
• Тестируйте скрипты в контролируемых условиях, искусственно вызывая ошибки (например, удаление необходимого файла во время выполнения).

Правильная обработка ошибок превращает bash скрипт из простого автоматизированного задания в надежный, производственный компонент инфраструктуры, что особенно важно в DevOps практике.