Краткий ответ

Имя функции будет привязано не к исходной функции, а к объекту, который вернул декоратор. Если этот объект не поддерживает протокол вызова, попытка вызвать имя завершится ошибкой TypeError.

Исторический контекст

Декораторы появились как удобный способ изменять или регистрировать функции в момент их определения, не переписывая тело функции и не выполняя явное присваивание результата вручную. Механизм основан на обычном поведении Python: функция является объектом, а декоратор получает этот объект и возвращает новое значение, которое становится содержимым имени функции.

Постановка проблемы

Разработчик может ожидать, что декоратор только добавит логирование, проверку прав или регистрацию обработчика. Однако декоратор не обязан возвращать функцию: он может вернуть любой объект, включая None, словарь или экземпляр класса.

Если возвращённый объект невызываем, прежний вызов функции перестаёт работать. Ошибка часто проявляется далеко от места применения декоратора, например при обработке HTTP-запроса или запуске задачи.

Подробное решение

После применения декоратора имя функции фактически получает результат вызова декоратора. Поэтому декоратор, возвращающий словарь, превращает имя функции в ссылку на словарь; исходная функция при этом не исчезает немедленно, но через это имя уже недоступна.

def replace(fn):
    return {"name": fn.__name__}

@replace
def greet():
    return "hello"

print(greet["name"])
try:
    greet()
except TypeError as exc:
    print(type(exc).__name__)

В примере greet содержит словарь, а не функцию. Поэтому обращение по ключу допустимо, но вызов greet() приводит к TypeError: словарь не является вызываемым объектом.

Если декоратор должен сохранить возможность вызова, он обязан вернуть либо исходную функцию, либо другой объект с методом __call__. На практике чаще возвращают обёртку-функцию, чтобы добавить поведение и сохранить привычный интерфейс вызова.

Иногда невызываемый результат является намеренным: декоратор может регистрировать функцию и возвращать дескриптор, идентификатор или другой объект управления. Тогда это должно быть частью явно задокументированного API, поскольку имя, выглядящее как функция, больше нельзя безопасно вызывать.

Проверка callable помогает обнаружить очевидную ошибку, но не гарантирует корректность объекта. Вызываемый объект может принимать другую сигнатуру, выбрасывать исключение внутри __call__ или нарушать ожидаемые контракт и побочные эффекты.

Ситуация из практики

В системе маршрутизации декоратор регистрировал обработчик в таблице маршрутов, но в конце функции ничего не возвращал. В результате имя обработчика получало значение None, и прямой вызов обработчика в тестах завершался ошибкой.

Рассматривались три варианта. Возвращать None можно, если имя должно быть только маркером регистрации, но это ломает привычный интерфейс. Возвращать специальный невызываемый объект можно для сложного управления маршрутом, однако такой API требует отдельной документации и меняет ожидания пользователей. Возвращать исходную функцию проще и безопаснее, а обёртку стоит использовать, если регистрация должна сопровождаться дополнительной логикой при вызове.

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

Что кандидаты часто упускают

Сохраняется ли исходная функция после возврата невызываемого объекта?

Да, она может сохраняться в другом месте: например, в таблице регистрации, замыкании декоратора или атрибуте объекта. Но имя, к которому применён декоратор, больше на неё не ссылается. Доступность исходной функции определяется только тем, сохранил ли её декоратор где-либо ещё.

Достаточно ли вернуть любой объект с методом __call__, чтобы корректно заменить функцию?

Нет. Такой объект будет вызываемым, но его интерфейс должен соответствовать ожиданиям к исходной функции: принимать совместимые аргументы, возвращать согласованный результат и корректно обрабатывать исключения. Также могут измениться атрибуты функции, поведение дескриптора и инструменты introspection, если декоратор специально не сохраняет метаданные.

Почему ошибка может возникнуть не во время применения декоратора, а значительно позже?

Применение декоратора обычно успешно завершается независимо от типа возвращённого объекта: Python просто присваивает этот результат имени. Ошибка появляется только в момент операции, требующей вызова, поэтому проблема может проявиться при обработке запроса, запуске фоновой задачи или выполнении теста. Для раннего обнаружения полезны проверки вызываемости и тесты публичного контракта декорируемой функции.