Base64字符串解码写入文件失败的主因是未剥离data URL前缀（如"data:image/png;base64,"），导致FormatException；必须用IndexOf(",")+1截取子串，且须用File.WriteAllBytes()写原始字节，避免文本编码污染。
Base64字符串解码后写入文件失败：常见错误是没跳过data URL前缀
直接用 Convert.FromBase64String() 解码报错 System.FormatException: Invalid length for a Base-64 char array，大概率是因为字符串带了 "data:image/png;base64," 这类前缀。它不是合法Base64内容，必须先剥离。
- 用
string.IndexOf(",")找到第一个逗号位置，取子串：base64Data.Substring(base64Data.IndexOf(",") + 1) - 若不确定是否含前缀，可加防护判断：
if (base64Data.Contains("base64,")) - 注意：空格、换行、BOM头也会导致解码失败，建议先
Trim()
FileStream写入图片时图片打不开：二进制数据被文本编码污染
用 File.WriteAllText() 或 StreamWriter 写Base64解码后的字节——这是最典型的误操作。这些API默认走UTF-8文本编码，会篡改二进制数据，生成的文件必然损坏。
- 必须用
File.WriteAllBytes()或FileStream配合Write()方法写原始字节 - 不要用
Encoding.UTF8.GetBytes()处理已解码的byte[]，那等于二次编码 - 路径中含中文或特殊字符？确保目录存在，用
Directory.CreateDirectory(Path.GetDirectoryName(filePath))预创建
保存后图片尺寸异常或颜色失真：扩展名与实际格式不匹配
Base64字符串声称是PNG，但实际内容是JPEG，或反之——浏览器和编辑器往往靠文件头（magic bytes）识别格式，而非扩展名。扩展名错会导致预览失败或渲染异常。
- 检查前4字节：
bytes[0] == 0xFF && bytes[1] == 0xD8是JPEG；bytes[0] == 0x89 && bytes[1] == 0x50是PNG - 别硬编码
".png"，优先从Base64前缀提取：Regex.Match(data, @"data:image/(\w+);base64,") - 更稳妥的做法：用
Image.FromStream()加载后查RawFormat，再选扩展名
大Base64字符串内存暴涨：避免一次性加载整个字节数组
几MB的Base64字符串解码后会变成约1.3倍大小的纯字节（Base64膨胀率≈33%），若同时处理多个，容易触发 OutOfMemoryException，尤其在32位或内存受限环境。
- 对超长Base64，改用
Convert.FromBase64CharArray()分段解码 +FileStream.Write()流式落盘 - 或用
Span<char></char>+stackalloc byte[...]控制栈上分配（C# 7.2+，仅限小块） - 生产环境建议加长度校验：
if (base64.Length % 4 != 0) throw new ArgumentException("Invalid Base64 length")
Base64转图本质是“字符串→字节→文件”的链路，每个环节都可能被当成文本处理。真正卡住人的，往往是那个藏在开头的逗号，和那个你以为只是后缀、其实决定系统如何解析的扩展名。
