Как разобраться с сообщением об ошибке строки модуля в Python

Расширенные примеры ошибок в строке модуля Python

Ниже приведены нестандартные ситуации, в которых сообщение об ошибке строки модуля может ввести в заблуждение, а также демонстрация продвинутых методов отладки.

Циклический импорт с косвенной ссылкой

# Файл module_a.py
from module_b import func_b
def func_a():
    return func_b()

# Файл module_b.py
from module_a import func_a
def func_b():
    return func_a()

# При попытке импорта возникает ImportError: cannot import name 'func_a' from partially initialized module

Traceback (most recent call last):
  File "", line 1, in 
  File "module_a.py", line 1, in 
    from module_b import func_b
  File "module_b.py", line 1, in 
    from module_a import func_a
ImportError: cannot import name 'func_a' from partially initialized module 'module_a' (most likely due to a circular import)

Решение: перенести импорт внутрь функции или объединить модули. Показательный пример того, как трассировка указывает на несколько строк в разных модулях.

Ошибка в генераторе списка с лямбда-функцией

# Неправильная замыкания: все лямбды ссылаются на последнее значение i
funcs = [lambda: i for i in range(5)]
print(funcs[2]())  # Ожидается 2, но выводится 4

# Исправление: использование аргумента по умолчанию
funcs = [lambda x=i: x for i in range(5)]
print(funcs[2]())  # 2

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

Ошибка при использовании метаклассов или дескрипторов

class Meta(type):
    def __new__(cls, name, bases, dct):
        if 'custom' not in dct:
            raise TypeError("Класс должен содержать атрибут 'custom'")
        return super().__new__(cls, name, bases, dct)

class MyClass(metaclass=Meta):
    pass  # TypeError: Класс должен содержать атрибут 'custom'

Traceback (most recent call last):
  File "", line 1, in 
  File "", line 4, in __new__
TypeError: Класс должен содержать атрибут 'custom'

В таких случаях строка ошибки указывает на пользовательский код метакласса. Для исправления нужно добавить требуемый атрибут в класс или изменить метакласс.

Ошибка при динамическом импорте с помощью importlib

import importlib
try:
    module = importlib.import_module('some_package.nonexistent_module')
except ImportError as e:
    print(f"Ошибка импорта: {e}")
    # Трассировка покажет строку внутри importlib, а не в пользовательском коде

Для получения полной информации об ошибке используйте sys.exc_info() или модуль traceback. Это помогает понять, какой именно модуль не удалось загрузить.

Использование модуля traceback для детального анализа

import traceback
import sys

def risky_function():
    return 1 / 0

try:
    risky_function()
except ZeroDivisionError:
    print("Стек вызовов:")
    traceback.print_exc()
    # Также можно получить строку: traceback.format_exc()

Стек вызовов:
Traceback (most recent call last):
  File "", line 2, in 
  File "", line 1, in risky_function
ZeroDivisionError: division by zero

Этот подход даёт полную картину, включая строки из пользовательских функций и модулей.

Ошибка при несоответствии сигнатур в переопределении методов

class Base:
    def process(self, value):
        return value * 2

class Child(Base):
    def process(self, value, extra):  # лишний аргумент
        return (value * 2) + extra

obj = Child()
print(obj.process(10))  # TypeError: process() missing 1 required positional argument: 'extra'

Traceback (most recent call last):
  File "", line 1, in 
TypeError: process() missing 1 required positional argument: 'extra'

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