Base64 解码失败主因是含换行、空格或 data: 前缀；需清洗空白并截去前缀；解码后须验证字节有效性和图像格式，保存时注意路径权限与流状态。
Base64 字符串解码失败：Convert.FromBase64String 报错“输入不是有效的 Base-64 字符”
常见原因是字符串里混入了换行、空格，或开头带 data:image/png;base64, 这类 data url 前缀。c# 的 convert.frombase64string 对格式极其敏感，只接受纯 base64 字符（a-z、a-z、0-9、+、/、=），多一个回车就直接抛异常。
- 先用
str.Replace("r", "").Replace("n", "").Replace(" ", "")清洗空白字符 - 如果字符串以
data:开头，用str.Substring(str.IndexOf(',') + 1)截掉前缀再解码 - 别用
Trim()—— 它不处理中间的换行，无效
还原图像时提示“参数不是有效的图像”或黑图
解码成功 ≠ 图像有效。Base64 解出来的字节流必须是完整、未损坏的图像二进制数据，且格式要和扩展名一致（比如你按 .jpg 保存，但实际是 PNG 数据，Image.FromStream 可能不报错但渲染异常）。
- 解码后先检查字节数：
bytes.Length > 0，避免空数组传给图像构造器 - 用
using var ms = new MemoryStream(bytes); using var img = Image.FromStream(ms);，不要省略using，否则资源泄漏会导致后续图像操作失败 - 保存前建议用
img.RawFormat查看真实格式，比文件名更可靠
保存为文件时出现“GDI+ 中发生一般性错误”
这是 Windows GDI+ 在写文件时最典型的权限 / 路径 / 流状态错误，和 Base64 关系不大，但常在还原流程末尾爆发。
- 确保目标目录存在：
Directory.CreateDirectory(Path.GetDirectoryName(filePath)) - 检查
filePath是否含非法字符（如< > : " | ? *），尤其注意用户输入的文件名 - 别复用之前用于读取的
MemoryStream—— 它可能已关闭或 Position 在末尾，保存前要重置：ms.Position = 0; - 推荐用
File.WriteAllBytes(filePath, bytes)直接写原始字节，绕过Image.Save的 GDI+ 层，更稳
需要支持多种图像格式且不想硬编码扩展名
Base64 字符串本身不带格式信息，但解码后的字节头（magic number）可以判断。依赖文件扩展名容易出错，比如把 WebP 当 PNG 打开会失败。
- 读取前 4 字节：PNG 是
89 50 4E 47，JPEG 是FF D8 FF，GIF 是47 49 46 38 - 用
ImageFormat.Png/Jpeg/Gif匹配保存，别全用ImageFormat.Jpeg - .NET 6+ 可用
ImageCodecInfo.GetImageEncoders()查支持的编码器，但注意 WebP 需额外 NuGet 包（System.Drawing.Common不自带）
真正麻烦的不是解码，而是验证——从字符串清洗、字节完整性、格式识别到磁盘写入，每一步都可能静默失败。尤其是 Web 端传来的 Base64，换行符、URL 编码、截断问题比想象中多得多。
