Ошибки Python: как их находить и исправлять

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

1. Обработка множественных исключений

Часто требуется перехватить несколько типов ошибок и выполнить различные действия. Ниже показан пример работы с пользовательским вводом, где могут возникнуть ValueError, ZeroDivisionError и другие.

def safe_divide():
    try:
        a = float(input("Введите первое число: "))
        b = float(input("Введите второе число: "))
        result = a / b
    except ValueError:
        print("Ошибка: введено не число")
    except ZeroDivisionError:
        print("Ошибка: деление на ноль")
    except Exception as e:
        print(f"Неизвестная ошибка: {e}")
    else:
        print(f"Результат: {result}")
    finally:
        print("Завершение работы")

safe_divide()

Введите первое число: 10
Введите второе число: 0
Ошибка: деление на ноль
Завершение работы

Пояснение:

Блок else выполняется только если не возникло исключения. finally выполняется всегда, даже если исключение не перехвачено. Это гарантирует освобождение ресурсов.

2. Использование traceback для детальной диагностики

Модуль traceback позволяет получить полный стек вызовов и вывести его в удобном формате.

import traceback

def func_a():
    return 1/0

def func_b():
    func_a()

if __name__ == "__main__":
    try:
        func_b()
    except ZeroDivisionError:
        print("Возникло исключение. Подробности:")
        traceback.print_exc()

Возникло исключение. Подробности:
Traceback (most recent call last):
  File "example.py", line 12, in 
    func_b()
  File "example.py", line 7, in func_b
    func_a()
  File "example.py", line 4, in func_a
    return 1/0
ZeroDivisionError: division by zero

Пояснение:

traceback.print_exc() выводит аналогичный traceback, который Python показал бы без перехвата. Это помогает локализовать исходную строку ошибки.

3. Обработка KeyError при вложенных словарях

Часто работают с глубоко вложенными структурами, где ключи могут отсутствовать на любом уровне.

data = {'user': {'profile': {'name': 'Alice'}}}

try:
    # Безопасное извлечение значения с проверкой каждого уровня
    name = data['user']['profile']['name']
    print(f"Имя: {name}")
except KeyError as e:
    print(f"Отсутствует ключ: {e}")

# Альтернативный подход с dict.get() и вложенными вызовами
# Не рекомендуется из-за сложности чтения, но работает:
name = data.get('user', {}).get('profile', {}).get('name', 'Неизвестно')
print(f"Имя (через get): {name}")

Имя: Alice
Имя (через get): Alice

Пояснение:

Использование .get() с пустыми словарями по умолчанию предотвращает KeyError, но может скрывать ошибки в логике. Более явный способ - try-except.

4. AttributeError при динамических атрибутах

Если объект создается динамически (например, через namedtuple или types.SimpleNamespace), то отсутствие атрибута может проявляться неожиданно.

from collections import namedtuple

Person = namedtuple('Person', ['name', 'age'])
p = Person('Bob', 30)

try:
    # Ошибка: у namedtuple нет атрибута 'city'
    print(p.city)
except AttributeError as e:
    print(f"Ошибка атрибута: {e}")

# Проверка через hasattr
if hasattr(p, 'city'):
    print(p.city)
else:
    print("Атрибут city отсутствует")

Ошибка атрибута: 'Person' object has no attribute 'city'
Атрибут city отсутствует

Пояснение:

hasattr() проверяет наличие атрибута без генерации исключения, что удобно при работе с неопределенной структурой.

5. Обработка ошибок при работе с файлами (FileNotFoundError + PermissionError)

Кроме FileNotFoundError, при открытии файла может возникнуть PermissionError (отсутствие прав) или IsADirectoryError (попытка открыть папку).

import os

filename = '/etc/shadow'  # файл требующий root

try:
    with open(filename, 'r') as f:
        content = f.read()
except FileNotFoundError:
    print(f"Файл {filename} не найден")
except PermissionError:
    print(f"Нет прав на чтение {filename}")
except IsADirectoryError:
    print(f"{filename} является директорией")
except Exception as e:
    print(f"Неизвестная ошибка: {e}")

# Использование pathlib для более удобной проверки
from pathlib import Path
path = Path(filename)
if path.exists():
    if path.is_file():
        try:
            content = path.read_text()
        except PermissionError:
            print("Нет прав")
    else:
        print("Это не файл")
else:
    print("Файл не существует")

Нет прав на чтение /etc/shadow
Файл не существует

Пояснение:

Разделение типов исключений позволяет давать пользователю точные сообщения. pathlib упрощает проверки и чтение.

6. ValueError при работе с datetime

Преобразование строки в дату также может вызвать ValueError, если формат не совпадает.

from datetime import datetime

date_str = '2024-13-01'  # неверный месяц

try:
    date_obj = datetime.strptime(date_str, '%Y-%m-%d')
    print(date_obj)
except ValueError as e:
    print(f"Ошибка разбора даты: {e}")

# Проверка с помощью дополнительной валидации
import re
if re.match(r'^\d{4}-\d{2}-\d{2}$', date_str):
    month = int(date_str[5:7])
    day = int(date_str[8:10])
    if 1 <= month <= 12 and 1 <= day <= 31:
        # дополнительная проверка дней в месяце
        print("Дата валидна")
    else:
        print("Месяц или день вне диапазона")
else:
    print("Неверный формат даты")

Ошибка разбора даты: month must be in 1..12
Месяц или день вне диапазона

Пояснение:

Регулярное выражение только проверяет формат, но не валидность значений. Комбинирование try-except с предварительной проверкой уменьшает количество исключений.

7. Использование asserts для предотвращения ошибок

Иногда полезно добавить явные проверки в коде, чтобы ошибка возникла рано и с понятным сообщением.

def process_data(data):
    assert isinstance(data, list), "Данные должны быть списком"
    assert len(data) > 0, "Список не должен быть пустым"
    for item in data:
        assert isinstance(item, int), "Элементы должны быть целыми числами"
    return sum(data) / len(data)

try:
    print(process_data([1, 2, '3']))
except AssertionError as e:
    print(f"Ошибка проверки: {e}")

# Включение asserts происходит только при запуске без оптимизации (-O)
# Для production используйте явные if-raise

Ошибка проверки: Элементы должны быть целыми числами

Пояснение:

Assertions отключаются при запуске с флагом -O. Это удобно для отладки, но в серьезных приложениях лучше использовать if not condition: raise Exception(...).