AttributeError: модуль не имеет атрибута в Python

Расширенные примеры диагностики и обхода

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

import statistics

data = [1, 2, 3, 4]
print(statistics.medain(data))

AttributeError: module 'statistics' has no attribute 'medain'. Did you mean: 'median'?

import statistics

data = [1, 2, 3, 4]
print(statistics.median(data))

2.5

Явный импорт вложенного модуля

import xml
print(hasattr(xml, 'etree'))
try:
    print(xml.etree.ElementTree.Element('root').tag)
except AttributeError as err:
    print(type(err).__name__, err)

False
AttributeError module 'xml' has no attribute 'etree'

import xml
import xml.etree.ElementTree
print(hasattr(xml, 'etree'))
print(xml.etree.ElementTree.Element('root').tag)

True
root

Локальный файл перекрывает библиотеку

# Файл random.py в каталоге запуска
# main.py
import random
print(random.__file__)
print(random.randint(1, 10))

/project/random.py
AttributeError: module 'random' has no attribute 'randint'

# Файл больше не называется random.py
import random
print(random.__file__)
print(random.randint(1, 10))

/usr/lib/python3.11/random.py
7

Циклический импорт и частичная инициализация

# a.py
import b

def value():
    return 10

print(b.result)

# b.py
import a
result = a.value()

AttributeError: partially initialized module 'a' has no attribute 'value' (most likely due to a circular import)

# a.py
import b

def value():
    return 10

print(b.use_a())

# b.py
def use_a():
    import a
    return a.value()

10

Запасное значение через getattr

import platform

processor = getattr(platform, 'processor', lambda: 'неизвестно')
print(processor())
print(getattr(platform, 'python_implementation', lambda: 'нет')())

x86_64
CPython

Динамический импорт и обращение к атрибуту

import importlib

module_name = 'json'
attr_name = 'dumps'
module = importlib.import_module(module_name)
func = getattr(module, attr_name, None)
print(func({'ok': True}))

{"ok": true}

Модульный __getattr__ и __dir__

# config.py
def __getattr__(name):
    if name == 'debug':
        return False
    if name.startswith('db_'):
        return name.upper()
    raise AttributeError(f'module config has no attribute {name}')

def __dir__():
    return ['debug', 'db_host']

# main.py
import config
print(config.debug)
print(config.db_host)
try:
    print(config.missing)
except AttributeError as err:
    print(type(err).__name__, err)
print(dir(config))

False
DB_HOST
AttributeError module config has no attribute missing
['db_host', 'debug']

Экспорт через __all__ и импорт звёздочкой

# tools.py
__all__ = ['run']

def run():
    return 'run'

def stop():
    return 'stop'

# main.py
from tools import *
print(run())
try:
    print(stop())
except NameError as err:
    print(type(err).__name__, err)

run
NameError name 'stop' is not defined

Обёртка совместимости разных версий

import json

def to_json(value):
    dumps = getattr(json, 'dumps', None)
    if dumps is None:
        raise AttributeError('модуль json не содержит dumps')
    return dumps(value, ensure_ascii=False)

print(to_json({'город': 'Москва'}))

{"город": "Москва"}

Проверка метаданных установленного пакета

import importlib.metadata as md

try:
    version = md.version('requests')
    print('version:', version)
except md.PackageNotFoundError:
    print('пакет requests не установлен')

import requests
print(hasattr(requests, 'get'))
print(hasattr(requests, 'post'))

version: 2.31.0
True
True

Перезагрузка модуля после изменения файла

import importlib
import settings

print(settings.MODE)
importlib.reload(settings)
print(settings.MODE)

dev
prod

Проверка sys.modules и фактического имени

import sys
import math

module = sys.modules['math']
print(module is math)
print(getattr(module, 'sqrt', 'нет'))
print(getattr(module, 'sqr', 'нет'))

True

нет

Исключение в пользовательском __getattr__

class Proxy:
    def __getattr__(self, name):
        raise AttributeError(f'Proxy не имеет атрибута {name}')

p = Proxy()
try:
    p.data
except AttributeError as err:
    print(type(err).__name__, err)

AttributeError Proxy не имеет атрибута data

Импорт отсутствующего имени через from

try:
    from math import sqr
except ImportError as err:
    print(type(err).__name__, err)

ImportError cannot import name 'sqr' from 'math' (/usr/lib/python3.11/lib-dynload/math.cpython-311-x86_64-linux-gnu.so)

Прямое обращение math.sqr даёт AttributeError, а from math import sqr даёт ImportError. Различие полезно при обработке.

import math
try:
    print(math.sqr(4))
except AttributeError as err:
    print(type(err).__name__, err)

AttributeError module 'math' has no attribute 'sqr'