返回IAsyncEnumerable的API端点方法如何处理错误（CS1626）？

要解决这个问题，核心是避开C#编译器的限制——不能在带有catch子句的try块内部使用yield return。结合你的API场景，这里有两种简洁的处理方式：

方法1：提前参数验证（推荐） #

既然CallSomethingReturningAsyncStream会在参数为空时抛出ArgumentException，你可以在API端点方法里先做参数校验，直接抛出能让ASP.NET Core自动返回400 Bad Request的异常，完全不需要进入异步流的遍历逻辑：

[HttpGet("api/query")]
public async IAsyncEnumerable<dynamic> Query(string name)
{    
   if (string.IsNullOrWhiteSpace(name))
   {
       // 抛出BadHttpRequestException，框架会自动返回400响应
       throw new BadHttpRequestException("Name is missing", StatusCodes.Status400BadRequest);
   }

   // 参数合法后再遍历异步流
   await foreach(var item in _myService.CallSomethingReturningAsyncStream(name))
   {
       yield return item;
   }
}

这种方式不仅避免了编译器错误，还能提前拦截无效请求，性能更优，同时保留了服务方法内部的参数校验作为双重保障。

方法2：分离流获取与遍历逻辑 #

如果必须在服务方法抛出异常后处理，可以将异步流的获取和遍历逻辑分开，把可能抛出异常的流初始化放在try块中（无yield操作），遍历放在外部：

[HttpGet("api/query")]
public async IAsyncEnumerable<dynamic> Query(string name)
{    
   IAsyncEnumerable<dynamic> dataStream;
   try
   {
       // 仅获取流，不执行遍历/yield
       dataStream = _myService.CallSomethingReturningAsyncStream(name);
   }
   catch (ArgumentException ex)
   {
       // 捕获参数异常，转换为Bad Request响应
       throw new BadHttpRequestException(ex.Message, StatusCodes.Status400BadRequest);
   }

   // 在try块外遍历流并yield，避开编译器限制
   await foreach(var item in dataStream)
   {
       yield return item;
   }
}

为什么会出现CS1626错误？ #

C#编译器禁止在包含catch子句的try块内使用yield return，原因是异步迭代器的状态机需要维护迭代状态，而try-catch会破坏状态机的异常处理逻辑，导致编译器无法生成正确的代码。

内容的提问来源于stack exchange，提问作者Dušan