.NET 8 ASP.NET API传入合法Guid触发中间件序列化异常求助

问题现象 #

• 基于.NET 8开发ASP.NET API，本地使用IIS Express调试
• 端点通过URL Query接收Guid格式参数（尝试过直接用Guid类型或先接收string再转换），调用格式：[MyUrl]?MyParameter=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
• 调试时确认控制器方法能正常执行，数据库调用也能成功完成，但API始终返回中间件异常：

  InvalidOperationException: 类型'System.Runtime.CompilerServices.AsyncTaskMethodBuilder1+AsyncStateMachineBox1[REDACTED STACK TRACE]'上属性'Context'的类型'System.Threading.ExecutionContext&'因是指针类型、ref struct或包含未替换为特定类型的泛型参数，无法序列化或反序列化。

• 诡异的是，只要传入的Guid格式非法（比如缩短/加长长度、修改字符），请求就能正常返回，不会触发该异常

可能原因 #

这种异常的核心是请求管道中某个中间件尝试序列化包含ExecutionContext（ref struct类型）的对象，而合法Guid参数恰好触发了该中间件的特定逻辑分支。即使使用IIS Express，也会集成部分IIS默认模块，可能存在默认的请求处理逻辑在起作用；另外自定义中间件（如日志、监控类）也可能存在此类序列化问题。

解决方案 #

• 排查自定义中间件：检查项目中所有自定义中间件，尤其是涉及请求参数捕获、日志记录或异常处理的代码，确认是否在参数为合法Guid时，尝试序列化AsyncStateMachineBox或包含ExecutionContext的对象，这类类型本身无法被序列化，需避免直接操作。
• 临时禁用内置日志/监控中间件：如果启用了app.UseHttpLogging()、第三方APM监控中间件等，先临时禁用，测试是否能消除异常，定位问题来源。
• 调整参数绑定与转换逻辑：
  改用string类型接收参数，手动处理Guid转换并捕获异常，避免框架自动绑定可能触发的隐式逻辑：

  [HttpGet]
  public async Task<IActionResult> GetData([FromQuery] string myParameter)
  {
      if (!Guid.TryParse(myParameter, out var targetGuid))
      {
          return BadRequest("无效的Guid格式");
      }
      // 执行数据库操作
      var result = await _dataRepository.GetByGuid(targetGuid);
      return Ok(result);
  }
  

• 清理IIS Express缓存：删除%USERPROFILE%\Documents\IISExpress下对应站点的缓存文件，重启调试环境，排除缓存导致的异常。
• 更新.NET 8补丁：检查是否存在.NET 8的已知序列化bug，升级到最新的.NET 8补丁版本，部分框架层面的问题可能已被修复。

内容的提问来源于stack exchange，提问作者AssistantToTheRegionalManager