Завершение работы программы на Python: руководство по методам остановки

Раздел: Основы Python -> Управление выполнением

В Python существует несколько способов завершить выполнение программы. Выбор конкретного метода зависит от контекста: необходимо ли завершить процесс с кодом ошибки, выполнить очистку ресурсов или обработать внешние сигналы. Ниже рассмотрены основные варианты с примерами и типичными проблемами.

Основные способы завершения программы

Наиболее эффективным и распространённым решением является использование функции sys.exit(). Она выбрасывает исключение SystemExit, которое может быть перехвачено блоком try/except, но при отсутствии перехвата завершает интерпретатор с указанным кодом возврата.

import sys

# Успешное завершение с кодом 0
sys.exit(0)

# Завершение с ошибкой (код 1)
sys.exit(1)

Python end program (завершение программы в python)

Параметр code может быть целым числом или строкой (в последнем случае строка выводится в stderr).

Проблема: если sys.exit() вызван внутри try, исключение SystemExit может быть перехвачено, и программа продолжит работу.

Решение: либо не перехватывать SystemExit, либо после обработки перевызвать sys.exit() (или использовать os._exit() для гарантированного завершения).

Как завершить программу с кодом ошибки без выполнения очистки?

Функция os._exit() завершает процесс немедленно, минуя обработчики atexit, деструкторы объектов и блоки finally. Подходит для дочерних процессов после fork() или аварийных ситуаций.

import os

os._exit(2)  # Код возврата 2

Python окончание программы (завершение программы на python)

Проблема: не освобождаются временные файлы, не закрываются соединения с базами данных, не вызываются зарегистрированные через atexit функции.

Решение: применять os._exit() только в исключительных случаях, когда необходимо немедленно остановить процесс, например, в дочернем процессе после fork().

Как завершить интерактивную сессию Python?

Функции exit() и quit() (доступны только в интерактивном режиме) выбрасывают SystemExit, но не предназначены для использования в скриптах. В рабочем коде их следует заменять на sys.exit().

# В интерактивной оболочке:
exit()
# или
quit()

Python exit (код завершения программы в python)

Проблема: вызов exit() в скрипте, запущенном через модуль -m, может вызвать ошибку NameError.

Решение: для скриптов всегда использовать sys.exit().

Как завершить программу с собственным сообщением об ошибке?

Можно явно выбросить исключение SystemExit с текстовым параметром. Это эквивалентно sys.exit('сообщение').

raise SystemExit('Ошибка: файл не найден')

Сообщение будет выведено в stderr.

Проблема: если код выполняет перехват всех исключений (except Exception), SystemExit не перехватится, но BaseException перехватить можно – тогда программа не завершится.

Решение: использовать except SystemExit только тогда, когда это действительно необходимо для очистки, и после этого вызывать sys.exit() повторно.

Как организовать корректное завершение при нажатии Ctrl+C или отправке SIGTERM?

Сигналы SIGINT (Ctrl+C) и SIGTERM можно обработать, зарегистрировав пользовательский обработчик с помощью модуля signal.

import sys
import signal

def graceful_shutdown(signum, frame):
    print('Получен сигнал {}, завершение...'.format(signum))
    sys.exit(0)

signal.signal(signal.SIGINT, graceful_shutdown)
signal.signal(signal.SIGTERM, graceful_shutdown)

# Бесконечный цикл
while True:
    pass

Проблема: если внутри цикла выполняется длительная операция, сигнал будет обработан только после её завершения (в CPython). В многопоточных приложениях сигналы обрабатываются только главным потоком.

Решение: для многопоточных сценариев следует использовать флаг завершения (см. examples_adv).

Как плавно завершить бесконечный цикл без сигнала?

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

running = True

def stop():
    global running
    running = False

# Где-то вызывается stop() при выполнении условия
while running:
    # работа
    pass

print('Программа завершилась естественным образом.')

Проблема: если цикл заблокирован на вводе-выводе, изменение флага не прервёт текущую операцию.

Решение: использовать таймауты или неблокирующие вызовы.

Расширенные примеры завершения программы

Регистрация завершающих действий через atexit

Модуль atexit позволяет зарегистрировать функции, которые будут вызваны при sys.exit() или естественном завершении скрипта.

Пример

import atexit
import sys

def cleanup():
    print('Очистка ресурсов...')

def close_files():
    print('Закрытие файлов...')

atexit.register(cleanup)
atexit.register(close_files)

print('Основная работа')
sys.exit(0)

Основная работа
Закрытие файлов...
Очистка ресурсов...

Функции вызываются в обратном порядке регистрации. os._exit() игнорирует обработчики atexit.

Graceful shutdown многопоточного приложения

В многопоточном приложении для корректного завершения используется событие (threading.Event).

Пример

import threading
import time
import sys
import signal

stop_event = threading.Event()

def worker():
    while not stop_event.is_set():
        print('Работаю...')
        time.sleep(1)
    print('Поток завершён')

def signal_handler(signum, frame):
    print('Сигнал получен, завершение...')
    stop_event.set()
    sys.exit(0)

signal.signal(signal.SIGINT, signal_handler)
signal.signal(signal.SIGTERM, signal_handler)

thread = threading.Thread(target=worker)
thread.start()
thread.join()

Работаю...
Работаю...
^CСигнал получен, завершение...
Поток завершён

Завершение программы по таймеру (сигнал SIGALRM)

В Unix-подобных системах можно установить ограничение времени выполнения с помощью signal.alarm().

Пример

import signal
import sys

def timeout_handler(signum, frame):
    print('Время истекло!')
    sys.exit(1)

signal.signal(signal.SIGALRM, timeout_handler)
signal.alarm(5)  # Таймер на 5 секунд

# Долгая операция
import time
for i in range(10):
    time.sleep(1)
    print('Шаг', i)

Шаг 0
Шаг 1
Шаг 2
Шаг 3
Шаг 4
Время истекло!

Использование os._exit в дочернем процессе после fork

Пример

import os
import sys

pid = os.fork()
if pid == 0:
    # Дочерний процесс
    print('Дочерний процесс завершается немедленно')
    os._exit(0)
else:
    # Родительский процесс
    os.wait()
    print('Родитель завершается через sys.exit')
    sys.exit(0)

Дочерний процесс завершается немедленно
Родитель завершается через sys.exit

Перехват и повторный вызов SystemExit для логирования

Пример

import sys

def main():
    try:
        # Основная логика
        raise SystemExit('Критическая ошибка')
    except SystemExit as e:
        print('Логирование завершения:', e)
        sys.exit(e.code)  # Повторно выбрасываем SystemExit

if __name__ == '__main__':
    main()

Логирование завершения: Критическая ошибка

При этом скрипт завершится с тем же кодом, что и исходное исключение.

Завершение программы в Python - comments

Python end program (python)