Erros de padding em Base64: por que acontecem e como corrigir
Entenda os sinais =, erros de padding e regras seguras de reparo.
Resposta curta
Base64 trabalha em grupos de quatro caracteres. O último grupo pode precisar de um ou dois sinais = para reconstruir os bytes finais.
Conte antes de mexer
Remova espaços e quebras de linha. Resto 0 ao dividir por 4: não adicione nada. Resto 2: adicione ==. Resto 3: adicione =. Resto 1: o valor está incompleto ou usa outro alfabeto.
Confira o alfabeto
Base64 padrão usa + e /. Base64URL usa - e _. JWTs e tokens de rota costumam precisar do alfabeto URL-safe.
Não esconda corrupção
Corrija padding apenas quando a regra de comprimento permitir. Não apague caracteres aleatórios para calar o erro.
Fluxo seguro
Copie de novo, limpe espaços, escolha Base64 ou Base64URL, aplique módulo 4 e confira o tipo de saída.