Raising & Chaining

Traduce fallos de bajo nivel a errores de dominio sin perder contexto. Usa raise ... from, raise desnudo y from None intencionadamente para que los tracebacks cuenten la historia completa.

Receta

def load_user(user_id: str) -> dict:
    try:
        return fetch_row(user_id)
    except KeyError as exc:
        raise UserNotFoundError(user_id) from exc

Cuándo usar esto:

• Envolver excepciones de terceros en los límites de la API
• Añadir contexto de negocio preservando la causa raíz
• Suprimir tracebacks intermedios ruidosos (from None)
• Registrar y luego volver a lanzar con raise desnudo
• Encadenar errores de validación en arquitecturas en capas

Ejemplo de Trabajo

class UserNotFoundError(LookupError):
    def __init__(self, user_id: str) -> None:
        self.user_id = user_id
        super().__init__(f"user not found: {user_id}")
 
_DB: dict[str, dict] = {"1": {"name": "Ada"}}
 
def fetch_row(user_id: str) -> dict:
    return _DB[user_id]
 
def get_user(user_id: str) -> dict:
    try:
        return fetch_row(user_id)
    except KeyError as exc:
        raise UserNotFoundError(user_id) from exc
 
def parse_id(raw: str) -> str:
    try:
        value = int(raw)
    except ValueError:
        raise ValueError(f"invalid id: {raw!r}") from None
    if value < 1:
        raise ValueError("id must be positive")
    return str(value)
 
try:
    get_user("999")
except UserNotFoundError as exc:
    print(exc)
    print(exc.__cause__)

Lo que esto demuestra:

• from exc establece __cause__ para depurar cadenas
• from None oculta los detalles internos del analizador a los consumidores de la API
• Las excepciones de dominio transportan identificadores para manejadores y registros
• Los raise de validación desnudos aún producen mensajes claros

Inmersión Profunda

Cómo Funciona

• raise NewError() inicia una nueva excepción en el punto actual del traceback
• raise NewError() from exc enlaza exc como __cause__
• raise desnudo dentro de except vuelve a lanzar la excepción capturada en tránsito
• raise exc desde una variable almacenada puede restablecer el contexto del traceback; prefiere raise desnudo
• Exception.__context__ puede diferir de __cause__ cuando ocurre un encadenamiento implícito

Opciones de Encadenamiento

Trampas Comunes

• Perder la causa con raise New() sin from: el contexto implícito aún puede aparecer pero es ambiguo. Solución: usa siempre from exc al envolver.
• Ignorar con from None en todas partes: oculta las causas raíz en operaciones. Solución: reserva from None para los límites de análisis de entrada del usuario.
• raise exc después de que termina el bloque except: el traceback apunta al sitio de re-lanzamiento. Solución: raise desnudo solo dentro de un except activo.
• Bucles de encadenamiento: A desde B desde A en envoltorios recursivos. Solución: lanza el error de dominio una vez en el límite.
• Registrar exc_info y luego lanzar un tipo diferente sin from: los registros y el traceback no coinciden. Solución: encadena o registra dentro del manejador que vuelve a lanzar desnudo.

Alternativas

Preguntas Frecuentes

Relacionado

• Jerarquías de Excepciones Personalizadas - tipos de dominio
• Conceptos Básicos de Excepciones - estructura try/except
• Reintentos y Backoff - lanzar después de reintentos
• Mejores Prácticas de Errores y Logging - reglas operativas

Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.