Skip to content
Volver a proyectos

outbox-kit

En desarrollo

Cambia la base de datos y avisa a otro sistema, sin que ocurra una cosa y la otra no

Rol: Desarrollador en solitario

En solitario · Desde nov 2026 · Repo público

.NET 10EF CorePostgreSQLxUnitTestcontainers
25
Tests, contra PostgreSQL real
0
Prueba de caos: mensajes perdidos

Una biblioteca pequeña de .NET para el outbox transaccional sobre EF Core y PostgreSQL, más un consumidor idempotente. Unas 300 líneas, con pruebas que demuestran sus garantías contra una base real, una de ellas matando el proceso a mitad del envío.

Problema

Guardar un cambio y luego publicar un mensaje son dos pasos. Si el proceso muere entre ambos, el cambio existe y nadie se enteró. Si los inviertes, sale un mensaje de un cambio que nunca se confirmó.

Solución

El mensaje es una fila escrita en el mismo SaveChanges que el cambio, así que se confirman los dos o ninguno. Un despachador bloquea un lote con FOR UPDATE SKIP LOCKED, publica y marca las filas en una transacción. El consumidor registra el id del mensaje y ejecuta su manejador en una transacción, así que un reenvío se omite.

Todavía no

Solo PostgreSQL. Sin garantía de orden cuando un mensaje falla, sin limpieza de filas procesadas y sin métricas. No la medí, así que no afirmo ningún rendimiento. No está publicada en NuGet.

Puntos clave de arquitectura

  • La prueba de caos corre un segundo proceso y lo termina con Environment.FailFast entre publicar y confirmar. Nada queda marcado como procesado, un segundo worker termina: los 20 mensajes se procesan y el broker vio 23 publicaciones, tres duplicadas
  • Un consumidor que repite cada una de esas publicaciones dos veces aplica cada efecto exactamente una vez. At-least-once del outbox más el inbox da un efecto por mensaje
  • Tres despachadores a la vez publican cada uno de 40 mensajes exactamente una vez, y un mensaje venenoso se reintenta y se aparta sin bloquear al resto
  • Publico dentro de la transacción que bloquea a propósito: un fallo antes de confirmar deshace todas las marcas de esa ejecución, a costa de una transacción larga si el broker es lento. No hay ninguna garantía de orden
  • Una auditoría independiente encontró un error real en mi primera versión: un timeout del publicador nunca contaba como intento, así que un mensaje podía republicarse sin fin y nunca apartarse. Corregido, y el despachador ya no toca el change tracker del llamador, con 16 pruebas más