Понимание кодов возврата: эффективная обработка ошибок с помощью $? и exit

Когда Bash-скрипт завершается с ошибкой, код возврата сообщает вызывающей стороне, что делать дальше: продолжить, повторить, предупредить или остановиться. Понимание кодов возврата, $? и exit — это разница между автоматизацией, которая скрывает ошибки, и автоматизацией, которая четко их сообщает.

Это руководство показывает, как Bash отслеживает статус команд и как вы можете использовать этот статус для простой и надежной обработки ошибок.

Концепция статусов завершения

Каждая команда или программа, выполняемая в среде оболочки Unix-подобной системы — будь то встроенная команда, такая как cd, внешняя утилита, такая как grep, или другой скрипт оболочки — возвращает целое число после завершения. Это целое число является кодом возврата, который сигнализирует о результате операции вызывающему процессу.

Стандартное соглашение

Соглашение о кодах возврата является общепризнанным:

• 0 (Ноль): Означает успех. Команда выполнена точно так, как ожидалось, и ошибок не произошло.
• от 1 до 255: Означают сбой или конкретные условия ошибки. Эти ненулевые значения указывают на то, что что-то пошло не так. Более высокие числа часто соответствуют определенным типам ошибок (например, файл не найден, отказано в доступе, синтаксическая ошибка), хотя точное значение зависит от конкретной программы.

Примечание о диапазоне: Хотя технически коды возврата являются 8-битными значениями (0-255), скрипты оболочки обычно заботятся только о 0 для успеха и ненулевом значении для сбоя. Коды возврата больше 255 обычно усекаются или интерпретируются по модулю 256 оболочкой.

Проверка последнего кода возврата: переменная $?

Специальная переменная оболочки $? (доллар вопросительный знак) является центральной для мониторинга статуса команд. Сразу после выполнения любой команды оболочка сохраняет ее код возврата в $?.

Как использовать $?

Вы должны проверять $? немедленно после интересующей вас команды, так как любая последующая команда (даже вывод переменной) перезапишет ее значение.

Пример 1: Проверка успеха и сбоя

# 1. Успешная команда
echo "Тест успеха" > /dev/null
echo "Код возврата для успеха: $?"

# 2. Команда, завершающаяся с ошибкой (например, попытка вывести несуществующий файл)
ls /не/существующий/путь
echo "Код возврата для сбоя: $?"

Ожидаемый вывод:

Код возврата для успеха: 0
ls: невозможно получить доступ к '/не/существующий/путь': Нет такого файла или каталога
Код возврата для сбоя: 2

Реализация условной проверки ошибок

Простого знания кода возврата недостаточно; сила заключается в использовании этой информации для управления потоком скрипта. Обычно это делается с помощью операторов if или операторов короткого замыкания (&& и ||).

Использование операторов if

Это самый явный способ обработки ошибок:

if grep -q "важные данные" logfile.txt;
then
    echo "Данные успешно найдены."
else
    LAST_STATUS=$?
    echo "Ошибка: Grep завершился с статусом $LAST_STATUS. Данные не найдены."
    # Рассмотрите возможность выхода, если скрипт не может продолжить
fi

В приведенном выше примере grep -q подавляет вывод (-q) и возвращает 0 только в случае совпадения. Структура if автоматически проверяет статус выхода, но явный захват $? внутри блока else полезен для детального логирования.

Использование логики короткого замыкания (&& и ||)

Для простых последовательных проверок операторы короткого замыкания обеспечивают лаконичную обработку ошибок:

• && (И): Команда после && выполняется только в том случае, если предыдущая команда завершилась успешно (вернула 0).
• || (ИЛИ): Команда после || выполняется только в том случае, если предыдущая команда завершилась с ошибкой (вернула ненулевое значение).

Пример 2: Лаконичная обработка ошибок

# 1. Запускать 'process_data' ТОЛЬКО если 'fetch_data' завершился успешно
fetch_data.sh && ./process_data.sh

# 2. Запускать 'send_alert' ТОЛЬКО ЕСЛИ основная операция завершилась с ошибкой
rsync -a source/ dest/ || echo "RSync не удался $(date)" >> /var/log/rsync_errors.log

Управление завершением скрипта с помощью exit

Команда exit используется для немедленного завершения текущего скрипта оболочки или функции и возврата указанного статуса вызова вызывающей стороне (которая может быть другим скриптом или терминалом пользователя).

Синтаксис и использование

Синтаксис: exit [status_code].

Если статус не указан, exit по умолчанию использует статус последней выполненной команды переднего плана. Если вы явно вызываете exit 0 без предварительного выполнения какой-либо команды, он возвращает 0.

Пример 3: Выход при сбое предварительного условия

Этот скрипт проверяет наличие необходимого файла конфигурации перед продолжением.

CONFIG_FILE="/etc/app/config.conf"

if [[ ! -f "$CONFIG_FILE" ]]; then
    echo "Ошибка: Файл конфигурации не найден по пути $CONFIG_FILE."
    # Немедленно завершить скрипт с определенным кодом ошибки (например, 20)
    exit 20 
fi

echo "Конфигурация загружена. Продолжение скрипта..."
# ... остальная часть скрипта
exit 0

Лучшая практика: использование осмысленных кодов возврата

Хотя 0 и 1 покрывают большинство базовых случаев, использование различных ненулевых кодов помогает вызывающему скрипту диагностировать точную проблему:

Код	Значение (Пример)
0	Успех
1	Общая ошибка
2-10	Синтаксические ошибки, проблемы с аргументами
20	Отсутствует предварительное условие (например, файл не найден)
30	Проблема с правами доступа

Быстрое завершение скриптов при ошибках: команда set

Для максимальной надежности в сложных скриптах рекомендуется включать глобальную проверку ошибок с помощью опций команды set в начале скрипта:

#!/bin/bash

# Немедленно завершить, если команда завершается с ненулевым статусом.
set -e

# Считать неопределенные переменные ошибкой при подстановке.
set -u

# Pipefail: Обеспечивает, чтобы статус возврата конвейера был статусом самой правой команды, завершившейся с ненулевым статусом.
set -o pipefail

# (Необязательно, но полезно) Выводить команды по мере их выполнения для отладки
# set -x 

# Если любая из следующих команд завершится с ошибкой, скрипт немедленно остановится.
ls /valid/path && grep pattern file.txt && ./next_step.sh

# Следующая строка выполнится ТОЛЬКО если все предыдущие команды завершились успешно.
echo "Все шаги выполнены."

Когда активен set -e, многие необработанные ненулевые статусы останавливают скрипт до того, как последующие команды выполнятся на основе неверных предположений. У него есть исключения в условных операторах, конвейерах и составных командах, поэтому все равно явно обрабатывайте ожидаемые сбои.

Например, grep возвращает 1, когда не находит совпадений. Это может быть нормальным результатом, а не фатальной ошибкой:

if grep -q "ГОТОВО" status.txt; then
    echo "Сервис готов."
else
    echo "Сервис еще не готов."
fi

Вывод

Проверяйте критические команды там, где они выполняются, записывайте ошибки в stderr и завершайте скрипт с ненулевым статусом, когда он не может безопасно продолжить работу. Используйте set -euo pipefail для скриптов с быстрым завершением при ошибках, но не полагайтесь на это как на единственную стратегию обработки ошибок.