Código
Basado en el problema que fui el primero en resolver en Totalplay
Recuperación de la Exception Queue de Oracle AQ
Miles de clientes atorados, sin que nadie lo supiera.
15 archivos729 líneas de código 9/9 pruebas
using System.Text.Json;
namespace AqRecovery;
public sealed record RecoveryPolicyOptions(
int MaxRecoveryAttempts = 3,
TimeSpan? BaseDelay = null,
TimeSpan? MaxDelay = null,
TimeSpan? MaxMessageAge = null)
{
public TimeSpan EffectiveBaseDelay => BaseDelay ?? TimeSpan.FromMinutes(5);
public TimeSpan EffectiveMaxDelay => MaxDelay ?? TimeSpan.FromHours(2);
public TimeSpan EffectiveMaxAge => MaxMessageAge ?? TimeSpan.FromDays(7);
}
/// <summary>
/// Decide qué hacer con cada mensaje atorado. Es una función pura para poder probarla
/// exhaustivamente: la parte delicada del proceso no depende de Oracle.
///
/// Reglas:
/// 1. Un mensaje ilegible (vacío o JSON inválido) jamás se va a procesar bien: revisión manual.
/// 2. Un mensaje demasiado antiguo puede ya no ser válido para el negocio: revisión manual.
/// 3. Si ya se intentó recuperar demasiadas veces, es un "mensaje veneno": revisión manual.
/// 4. En cualquier otro caso se reencola con backoff exponencial, para no repetir
/// de inmediato la condición que lo hizo fallar (bloqueos, servicio caído…).
/// </summary>
public sealed class RecoveryPolicy
{
private readonly RecoveryPolicyOptions _options;
private readonly TimeProvider _clock;
public RecoveryPolicy(RecoveryPolicyOptions? options = null, TimeProvider? clock = null)
{
_options = options ?? new RecoveryPolicyOptions();
_clock = clock ?? TimeProvider.System;
}
public RecoveryAction Decide(QueueMessage message, int previousAttempts)
{
if (message.Payload.Length == 0)
return RecoveryAction.Review("Mensaje vacío");
if (!IsValidJson(message.Payload))
return RecoveryAction.Review("Contenido ilegible (JSON inválido)");
var age = _clock.GetUtcNow() - message.EnqueuedAt;
if (age > _options.EffectiveMaxAge)
return RecoveryAction.Review($"Mensaje con {age.TotalDays:N0} días de antigüedad");
if (previousAttempts >= _options.MaxRecoveryAttempts)
return RecoveryAction.Review($"Se agotaron {_options.MaxRecoveryAttempts} intentos de recuperación");
return RecoveryAction.Requeue(BackoffFor(previousAttempts), $"Reintento de recuperación {previousAttempts + 1}");
}
/// <summary>5 min, 10 min, 20 min… con tope.</summary>
public TimeSpan BackoffFor(int previousAttempts)
{
var factor = Math.Pow(2, Math.Clamp(previousAttempts, 0, 20));
var delay = TimeSpan.FromTicks((long)(_options.EffectiveBaseDelay.Ticks * factor));
return delay < _options.EffectiveMaxDelay ? delay : _options.EffectiveMaxDelay;
}
private static bool IsValidJson(byte[] payload)
{
try
{
using var _ = JsonDocument.Parse(payload);
return true;
}
catch (JsonException)
{
return false;
}
}
}