InterfaceError

Исключение InterfaceError является подклассом DatabaseError и выбрасывается при возникновении проблем, связанных с интерфейсом базы данных, а не с самой операцией SQL. Это исключение часто возникает при потере соединения с базой данных, превышении таймаута запроса, неправильной конфигурации подключения или ошибках на уровне сетевого взаимодействия между приложением и сервером базы данных. В отличие от IntegrityError, которое связано с нарушением целостности данных, или ProgrammingError, указывающего на синтаксические ошибки SQL, InterfaceError говорит о проблемах на более низком уровне соединения.

Основные причины возникновения InterfaceError: разрыв соединения с базой данных из-за длительного бездействия, перезапуск сервера БД, исчерпание пула соединений, сетевые сбои, неверные учетные данные или параметры подключения. В Django это исключение может быть перехвачено для реализации логики повторных попыток или graceful degradation.

Синтаксис

from django.db import DatabaseError, InterfaceError

try:
	# database operations
	pass
except InterfaceError:
	# handle interface error
	pass

Пример

Рассмотрим ситуацию, когда запрос к базе данных вызывает исключение InterfaceError из-за потери соединения:

from django.db import InterfaceError
from myapp.models import Article

try:
	article = Article.objects.get(id=1)
	print(article.title)
except InterfaceError as e:
	print(f"Database interface error: {e}")

Результат выполнения кода при возникновении ошибки:

"Database interface error: connection already closed"

Пример

Пример реализации повторной попытки выполнения запроса при возникновении ошибки интерфейса:

import time
from django.db import InterfaceError
from myapp.models import Article

max_retries = 3
retry_delay = 1
res = None

for attempt in range(max_retries):
	try:
		res = Article.objects.filter(status="published")
		break
	except InterfaceError:
		if attempt == max_retries - 1:
			raise
		time.sleep(retry_delay)

print(res)

Результат выполнения кода:

"[<Article: Published article>, <Article: Another article>]"

Пример

Обработка InterfaceError при выполнении нескольких запросов в рамках транзакции:

from django.db import transaction, InterfaceError
from myapp.models import Article, Category

try:
	with transaction.atomic():
		category = Category.objects.get(name="Tech")
		articles = Article.objects.filter(category=category)
		for article in articles:
			article.status = "archived"
			article.save()
except InterfaceError as e:
	print(f"Transaction failed: {e}")

Результат выполнения кода:

"Transaction failed: connection terminated unexpectedly"

Смотрите также

исключение DatabaseError,
базовое исключение для всех ошибок базы данных
исключение OperationalError,
возникает при проблемах с подключением и выполнением операций
исключение ProgrammingError,
возникает при синтаксических ошибках SQL
исключение IntegrityError,
возникает при нарушении целостности данных