Base64 解码排障实战：接口与数据链路通用清单
针对乱码、URL-safe 变体不一致和解码失败，提供可重复执行的排障流程。
Base64 问题多数不是算法错误，而是变体和字符集约定不一致。这份清单按排障顺序整理，适合接口联调和数据管道排查。
本指南涉及工具
1）先确认 Base64 变体
先区分标准 Base64（+, /, =）和 URL-safe Base64（-, _, 可选补位）。两者混用是解码失败高发原因。
如果数据走 query 参数，还要确认百分号编码与 Base64 的先后顺序。
2）再核对字符集和内容类型
解码后先判断是 UTF-8 文本、JSON 还是二进制，不要默认都按文本解释。
结合 MIME 或请求头上下文判断目标类型，避免下游解析器误处理。
3）把约定固化进文档与测试
为每个字段明确写清编码变体、补位规则和传输转义顺序。
补充无补位、非 ASCII 字节、鉴权头混合大小写等边界样例测试。