必须重置Position；写入后Position指向末尾，不重置会导致ToArray()或Base64编码读取空数据或脏字节，应设stream.Position = 0再读取。
MemoryStream写入后读取前必须重置Position
直接用 MemoryStream 转图片为 Base64 时，常见报错是空字符串、长度为 0 或 ArgumentException: Stream was not readable。根本原因是写入完成后 Position 已经指向流末尾，但后续调用 ToArray() 或 GetBuffer() 并不自动重置位置——而很多编码逻辑（比如 Convert.ToBase64String()）依赖从头开始读取。
实操建议：
- 写入完毕后务必手动设置
stream.Position = 0，再进行读取或转换 - 避免直接用
GetBuffer()：它返回底层数组，可能包含未写入区域的垃圾字节；优先用ToArray()（安全但有拷贝开销）或ReadOnlySpan<byte></byte>（.NET 5+） - 若用
new MemoryStream(byte[])构造，该流默认可读可写且Position = 0；但用无参构造后写入，就必须手动归位
图片保存格式不匹配导致Base64解码失败
把 Bitmap 或 Image 写入 MemoryStream 时，如果没指定正确的 ImageFormat，生成的字节流不是合法图片数据，Base64 编码虽能完成，但解码后无法还原为有效图片——浏览器或工具打开时显示损坏。
实操建议：
- 明确指定输出格式：例如 PNG 用
image.Save(stream, ImageFormat.Png)，JPEG 用ImageFormat.Jpeg - 不要依赖
Image.RawFormat：它反映原始加载格式，不代表你希望输出的格式；转换场景下必须显式指定 - 注意 JPEG 格式会丢弃 Alpha 通道，PNG 才保留透明度；选错格式会导致前端显示黑底或白底，误以为是 Base64 问题
Dispose时机不当引发“Cannot access a closed Stream”
在 ASP.NET Core API 或异步方法中，常因过早调用 stream.Dispose() 或使用 using 提前释放，导致后续 ToArray() 或 Convert.ToBase64String() 报错 ObjectDisposedException。
实操建议：
-
MemoryStream的Dispose()只释放托管资源（如内部 byte[]），不影响已写入数据，但会将CanRead/CanWrite设为false；所以必须在所有读取操作完成后才 Dispose - 推荐写法：先
stream.Position = 0，再var bytes = stream.ToArray()，最后stream.Dispose()；或用using var stream = new MemoryStream()包裹整个写入+读取流程 - 避免在
Task.Run或async方法里跨 await 边界持有未完成读取的 stream 实例
大图场景下MemoryStream内存暴涨甚至OOM
处理几 MB 以上的图片时，MemoryStream 默认按倍增策略扩容内部 buffer（如 256B → 512B → 1KB…），最终分配的数组可能远大于实际图片体积，尤其在高并发 API 中容易触发 GC 压力或 OutOfMemoryException。
实操建议：
- 初始化时预估大小：例如
new MemoryStream(image.Width * image.Height * 4)（RGBA 近似上限），减少重分配 - 对超大图（>5MB），考虑改用
FileStream临时落盘 + 分块 Base64 编码，或前端直传 Base64（需权衡 HTTP body 体积） - .NET 6+ 可用
MemoryPool<byte>.Shared.Rent()</byte>配合Stream.CopyToAsync()控制缓冲区，但需自行管理生命周期，复杂度上升
真正卡住人的往往不是 Base64 编码本身，而是 MemoryStream 的 Position、ImageFormat 和生命周期这三点交叉作用——漏掉任意一个，错误现象都像“玄学”，但其实每一步都有确定的内存状态可验证。
