最稳妥方式是用 File.ReadAllBytes 读取图片字节数组后调用 Convert.ToBase64String；若从 Bitmap/Image 转，须显式指定 ImageFormat 并重置 MemoryStream.Position=0；Base64 字符串需手动拼接 data URL 前缀，且注意传输大小与格式一致性。
用 Convert.ToBase64String 直接转字节数组最稳妥
图片转 Base64 的本质就是把二进制数据编码成 ASCII 字符串，C# 里最直接的方式是先读取图片为 byte[]，再交给 Convert.ToBase64String。别绕路去用 MemoryStream + Image.Save 再读取——容易因编码、格式、流位置导致空数组或异常。
- 推荐用
File.ReadAllBytes读本地文件，简单且自动处理流关闭 - 如果是从
Image或Bitmap对象来，必须指定格式（如Png），否则默认保存为MemoryBmp，生成的 Base64 在网页里打不开 - 注意：
Convert.ToBase64String不加前缀（如data:image/png;base64,），需要自己拼 —— 很多人传到前端后发现图片不显示，就卡在这一步
string imagePath = @"C:\test.jpg";
byte[] bytes = File.ReadAllBytes(imagePath);
string base64 = Convert.ToBase64String(bytes);
string dataUrl = $"data:image/jpeg;base64,{base64}";从 Bitmap 或 Image 转时，必须显式指定 ImageFormat
直接调 image.Save(stream, ImageFormat.Jpeg) 看似合理，但漏掉 stream.Position = 0 就会得到空字符串；更隐蔽的问题是：如果原图是 PNG 但你用 Jpeg 格式保存，透明通道就丢了，而 Base64 本身不报错，问题要到前端渲染才暴露。
- 务必在
Save后把流指针重置：stream.Position = 0 - 格式尽量和原始图片一致，或按使用场景选（网页常用
Png或Jpeg） - 避免用
ImageFormat.MemoryBmp—— 它不是标准图像格式，浏览器不认
using (var ms = new MemoryStream())
{
bitmap.Save(ms, ImageFormat.Png);
ms.Position = 0;
byte[] bytes = ms.ToArray();
string base64 = Convert.ToBase64String(bytes);
}传输前考虑大小和性能：大图别直接塞 JSON
一张 5MB 的 JPG 编码后 Base64 字符串约 6.7MB，再放进 JSON 里传输，不仅拖慢 API 响应，还可能触发 ASP.NET Core 默认 32MB 请求体限制或前端 JSON 解析超时。
- 单图建议上限控制在 2MB 以内（对应 Base64 约 2.7MB）
- 不要把 Base64 当“通用数据容器”往 DTO 里硬塞；优先考虑文件上传接口 + 返回 URL
- 如果必须传 Base64，后端接收用
[FromBody] string base64Data比绑定整个含 Base64 字段的模型更轻量
FormatException 和 ArgumentNullException 是最常见的两个坑
这两个异常几乎都指向同一个源头：传给 Convert.FromBase64String 的字符串不合法。但实际写“转 Base64”逻辑时，它们反而常出现在反向操作（解码）中 —— 比如前端传来的字符串被 URL 编码过、末尾多了换行或空格、或者压根没传全（截断）。
- 解码前先用
base64.Trim().Replace("\n", "").Replace("\r", "")清理 - 检查是否含
data:前缀，有就用Substring切掉，否则FromBase64String必炸 - Base64 长度必须是 4 的倍数，不足要补
=；但现代浏览器发来的通常已规范，服务端主动补容易掩盖真实问题
图片转 Base64 看似一行代码的事，真正上线后出问题的，八成卡在格式隐含行为、流位置、前后缀拼接或传输边界上。尤其当它混在 JSON 里传，一个空格或一次未重置的 MemoryStream 就能让整条链路静默失败。
