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.

C# 81%SQL 13%MSBuild 6%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;
        }
    }
}