ASP.NET Core 9.0中IAsyncEnumerable异常返回的JSON格式问题解析

在ASP.NET Core 9.0版本中，开发人员发现了一个与IAsyncEnumerable异常处理相关的重要问题。当端点返回IAsyncEnumerable类型并在未产生任何数据前抛出异常时，系统返回的ProblemDetails JSON响应会出现格式错误，响应内容会被"["字符前缀污染。

这个问题源于System.Text.Json在9.0版本中的一项优化改进。开发团队为了提升性能，新增了直接使用PipeWriter进行JSON序列化的支持，并将此优化应用到了Minimal API、MVC和HttpResponseWritingExtensions中。

问题的核心机制在于：当内部Utf8JsonWriter被释放时，无论是否发生异常，它都会强制刷新缓冲区中的所有数据。由于JSON数组序列化会立即在缓冲区中添加"["字符，这个字符就会被错误地刷新到输出中。值得注意的是，这个问题不会出现在使用Stream重载的情况下，因为内部流会被包装在缓冲PipeWriter中，当Utf8JsonWriter刷新时不会直接写入流。

从技术实现层面来看，这个问题的特殊性在于：

1. 只影响返回IAsyncEnumerable类型的端点
2. 仅在未产生任何输出数据前抛出异常时出现
3. 导致原本规范的ProblemDetails响应格式被破坏
4. 在.NET 8及更早版本中表现正常

对于开发人员而言，这个问题可能会影响API客户端的错误处理逻辑，因为非标准的JSON格式可能导致客户端解析失败。在等待官方修复的同时，开发团队可以考虑暂时回退到.NET 8版本，或者实现自定义的异常处理中间件来规避此问题。

这个问题也提醒我们，在进行框架级性能优化时，需要全面考虑各种边界条件和异常场景，确保功能完整性的同时提升性能。特别是在涉及序列化/反序列化这类基础功能时，任何细微的改变都可能产生广泛的影响。