Principales Errores de Decodificación Base64
1. "La entrada no es una cadena Base-64 válida" / FormatException
Causa: La cadena contiene caracteres ilegales fuera del alfabeto Base64 (espacios, saltos de línea o %20) o le falta el relleno = obligatorio.
Solución: Use nuestra Herramienta Validadora Base64 para limpiar espacios en blanco y caracteres no válidos automáticamente.Validador Base64
2. Caracteres Corruptos Tras Decodificar (Corrupción UTF-8)
Causa: Decodificar caracteres UTF-8 multibyte (emojis, acentos) usando decodificadores ASCII antiguos (como atob() nativo).
Solución: Decodifique siempre bytes UTF-8 multibyte usando TextDecoder('utf-8') en lugar de conversión simple a cadenas ASCII.
3. Errores de Relleno Faltante (Longitud % 4 != 0)
Causa: Muchas APIs e implementaciones de Base64URL eliminan los caracteres = finales antes de la transmisión.
Solución: Calcule str.length % 4 y añada caracteres = faltantes hasta que la longitud sea divisible por 4.