Base64解码失败主因是输入未清洗或编码不匹配，需清理空格换行、还原URL编码、补全填充符、校验格式；乱码因字符集不一致，须统一UTF8；大字符串应流式解码。
Base64 解码失败，八成是输入字符串没清理干净或编码不匹配，不是 Convert.FromBase64String() 本身有问题。
Convert.FromBase64String() 报 FormatException 怎么办
这个异常几乎总是因为输入字符串含非法字符、长度不对，或被意外截断。.NET 不会自动容忍换行、空格、URL 替换符或缺失的填充。
- 先做基础清洗：
input.Replace(" ", "").Replace(" ", "").Replace(" ", "") - 若来自 URL（如 JWT payload、查询参数），必须还原 Base64Url 规则：
input.Replace('-', '+').Replace('_', '/') - 检查长度是否为 4 的倍数；不是就补
=：用input.PadRight(input.Length + (4 - input.Length % 4) % 4, '=') - 别信“看起来像 Base64 就能解”——用正则
^[A-Za-z0-9+/]*={0,2}$粗筛一下，至少排除明显非法串
解码后中文变乱码或抛 ArgumentException
这不是 Base64 的问题，是编码/解码时用的字符集不一致。Convert.FromBase64String() 只负责字节，Encoding.UTF8.GetString() 才决定怎么解释这些字节。
- 编码时用了
Encoding.UTF8.GetBytes()，解码就必须用Encoding.UTF8.GetString() - 绝对不要用
Encoding.Default—— 它依赖系统区域设置，换台机器就可能崩 - 如果原始数据本就是二进制（如图片、PDF），跳过
GetString()，直接操作byte[]；乱码说明你误把它当文本处理了
从 HTTP Header 或 JSON 里取 Base64 字符串要注意什么
传输层会悄悄改写内容，尤其在跨语言、跨框架场景下。
- HTTP Authorization 头里的 Basic 认证，必须用
Encoding.ASCII.GetBytes("user:pass")，不能用 UTF-8 —— 协议强制 ASCII - JSON 字符串内嵌 Base64 是安全的，但注意反斜杠转义：如果 JSON 是从文件或 API 读的，确保它没被双重转义（比如
"SGVsbG8="变成"SGVsbG8\="） - HTML data URI 中的 Base64（如
data:image/png;base64,iVBORw...），浏览器会自动忽略中间空白，但 .NET 不会 —— 仍需手动清理
大 Base64 字符串解码内存爆掉怎么办
Convert.FromBase64String() 要求整个字符串加载进内存。一个 100MB 的原始文件 Base64 后约 133MB，再解码成 byte[] 又是 100MB，GC 压力极大。
- 别一次性调用 —— 改用流式处理：把 Base64 字符串按每 4 字符一组切分，用
Convert.FromBase64CharArray()分块解码到缓冲区 - 更稳方案：用
ReadOnlySpan+Convert.TryFromBase64Chars()（.NET 5+），零分配、可中断 - 如果源头可控，优先传二进制流（如
Stream），而不是 Base64 字符串 —— 编码只是妥协，不是设计目标
最常被忽略的一点：Base64 解码永远只输出 byte[]，它不管你是想还原成字符串、保存为文件，还是喂给图像解码器。后续逻辑错，不是解码错了，而是你忘了自己当初为什么编码。
