Blog
Laravel5 min

Laravel 13.42: UUID tipado y evento MigrationFailed

Laravel 13.42 añade uuid() y ulid() tipados, el evento MigrationFailed y razones de skip en tareas programadas. Qué cambia para migraciones y APIs.

Editor de código PHP en una estación de trabajo preparada para desarrollo Laravel

Laravel 13.42.0 llegó el 11 de noviembre de 2026 con un conjunto de cambios que no buscan titulares, pero que resuelven problemas muy concretos de APIs y migraciones. Dos destacan para cualquier equipo con datos sensibles: los helpers uuid() y ulid() con tipos reales, y el evento MigrationFailed.

He leído la nota de Laravel News y las referencias de los pull requests. Esto es lo que me parece útil en producción y lo que no conviene interpretar de más.

uuid() y ulid() devuelven objetos, no strings

Laravel ya tenía helpers como date() y enum() para convertir input. La versión 13.42 añade uuid() y ulid() al trait InteractsWithData, así que funcionan tanto en $request como en Fluent, input validado, query strings de Uri, atributos de componentes y comandos de consola.

$orderId = $request->uuid('order_id'); // Ramsey\Uuid\UuidInterface|null
$token = $request->ulid('token');      // Symfony\Component\Uid\Ulid|null

$validated = $request->safe()->uuid('order_id');

El comportamiento es el que esperarías de un helper tipado:

  • si el campo falta o está vacío, devuelve null;
  • si el valor no es un UUID válido, lanza una excepción;
  • ulid() solo acepta un ULID real; si le pasas un UUID, falla en lugar de convertirlo.

Esto evita una clase de bug muy común: comparar strings con formatos distintos y aceptar valores que parecen identificadores pero no lo son. En un endpoint que recibe un order_id, el helper hace la validación antes de que el valor llegue al modelo.

Un ejemplo de uso en un controlador:

public function show(Request $request): JsonResponse
{
    $id = $request->uuid('order_id');

    $order = Order::query()
        ->whereKey($id?->toString())
        ->firstOrFail();

    return response()->json($order);
}

Si el identificador es obligatorio, añade una regla de validación explícita. El helper devuelve null cuando falta el campo, y eso puede ser correcto o puede ser un error de negocio. No lo dejes implícito.

MigrationFailed: qué hacer cuando una migración falla a medias

El evento MigrationFailed se dispara cuando una migración lanza una excepción. Tiene las mismas propiedades que los otros eventos de migración (migration, method, name) y añade exception. La excepción se sigue propagando después del evento.

Esto importa especialmente en MySQL: un ALTER TABLE no se revierte si falla una sentencia posterior de la misma migración. Puedes quedarte con un esquema a medio aplicar mientras la aplicación sigue recibiendo tráfico.

Un listener básico para alertar y poner la aplicación en mantenimiento:

use Illuminate\Database\Events\MigrationFailed;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\Log;

Event::listen(function (MigrationFailed $event) {
    Artisan::call('down');

    Log::channel('slack')->critical("Migration [{$event->name}] failed", [
        'exception' => $event->exception->getMessage(),
    ]);
});

Dos matices:

  1. Artisan::call('down') dentro del listener puede fallar si la base de datos es justo lo que está roto. Para un caso crítico, prefiere una alerta externa y un healthcheck que deje de responder.
  2. No silencies la excepción. El evento es para observabilidad y para reducir el impacto, no para ocultar el fallo.

En un pipeline, yo añadiría además un paso que compruebe el estado de las migraciones antes de desplegar y un backup verificado antes de cualquier cambio destructivo. El evento ayuda a reaccionar; no sustituye el plan de rollback.

Scheduler: razones de skip y timezones reales

El evento ScheduledTaskSkipped ahora incluye una propiedad reason con un enum de tres casos: ConditionNotMet, Paused y RanOnAnotherServer. Eso permite distinguir por qué no se ejecutó una tarea sin adivinar por logs.

use Illuminate\Console\Events\ScheduledTaskSkipped;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\Log;

Event::listen(function (ScheduledTaskSkipped $event) {
    Log::info('Scheduled task skipped', [
        'task' => $event->task->getSummaryForDisplay(),
        'reason' => $event->reason?->value,
    ]);
});

También cambia schedule:list --json: ahora devuelve la expresión cron y el timezone propios de cada tarea. Antes convertía todo al timezone de la aplicación, lo que producía una hora de desfase después de un cambio de horario. Si tienes un script que parsea ese JSON, revisa las tareas que definen su propio timezone().

Otras mejoras que sí usaría

  • Uri::origin(): devuelve esquema, host y puerto normalizados. Útil para comparar orígenes en webhooks, redirecciones y validación de URLs.
  • LostConnectionDetector::detectUsing(): permite añadir tu propia detección de conexión perdida sin reemplazar el detector completo. Práctico si usas un proxy como Vitess y los mensajes de error no coinciden con los patrones de Laravel.
  • Macros en PendingProcess: antes solo funcionaban como primera llamada de la cadena; ahora se pueden componer.
  • Soporte para ably/pubsub-server: la instalación de broadcasting con Ably usa el paquete nuevo. Las apps con ably/ably-php 1.x siguen funcionando.

Cómo lo aplicaría en una migración real

Si estás migrando datos desde un ERP o CRM a una aplicación propia, el helper y el evento son útiles, pero el trabajo real está en el proceso:

  1. Inventario de datos: tablas, campos, relaciones y reglas de negocio.
  2. Mapeo explícito: cada campo origen tiene un destino y una transformación documentada.
  3. Ensayo sobre una copia: restaura un backup en staging, no en producción.
  4. Validación por muestreo y por totales: importes, fechas, estados y relaciones.
  5. Import idempotente: poder repetir sin duplicar registros.
  6. Ventana de corte y rollback: saber cuánto dura y cómo se revierte.
  7. Observabilidad: MigrationFailed, logs, métricas y alertas.

El código de la migración es la parte visible. La mayor parte del riesgo está en los datos que no encajan en el modelo nuevo.

Si estás en esa fase, puedes ver cómo enfoco una migración de datos de ERP/CRM o revisar el resto de servicios para aplicaciones creadas con IA.

Conclusión

Laravel 13.42 es una versión de mantenimiento, pero trae dos mejoras que un equipo con datos reales debería adoptar: input tipado para identificadores y visibilidad cuando una migración falla. Ninguna de las dos sustituye un plan de migración. Solo hacen que los errores sean más fáciles de detectar antes de que los vean los usuarios.

Actualizar es rápido. Diseñar una migración que puedas revertir es el trabajo que importa.

Siguiente paso

Revisa mi perfil como desarrollador

Si este artículo encaja con los retos técnicos de tu equipo, revisa mi stack o mi disponibilidad profesional.

Ver disponibilidadVer mi stack

Cuéntame qué necesitas

Con nombre, email, motivo y mensaje es suficiente. Respondo en menos de 24 horas hábiles y, si hay NDA, lo firmamos antes de compartir detalles.

0/500
¿Prefieres email directo?ignacioamat@ignathedev.comLinkedIn
Disponibilidad