Blazor API偶发404错误及<'无效起始值'问题原因与解决求助

可能的根源 #

• 路由匹配异常：Blazor客户端路由与API路由存在冲突，或服务器端端点注册有延迟/不稳定情况，导致请求偶尔被错误路由到静态HTML页面（比如404错误页），客户端预期接收JSON响应，解析时遇到HTML开头的<字符就抛出错误。
• 响应格式不匹配：API服务器出现临时异常时，返回的是HTML格式错误页而非JSON，客户端未做格式校验就直接反序列化，引发解析错误。
• 服务端临时不可用：应用池回收、进程重启或资源过载期间，API端点暂时无法响应，返回404状态码及HTML错误内容，触发客户端解析异常。
• 路由缓存未及时更新：Blazor客户端的路由缓存或服务器端路由表刷新不及时，偶尔导致请求发送至已失效的端点路径。

解决办法 #

• 隔离API与Blazor路由：给所有API控制器添加统一前缀，比如[Route("api/[controller]/[action]")]，确保客户端请求路径（如/api/YourController/UpdateValue）不会与Blazor页面路由（如/counter）混淆。
• 强制请求JSON响应：在HttpClient请求中显式设置请求头：

  httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
  

  让服务器优先返回JSON格式错误，避免解析HTML的<字符问题。
• 添加响应状态校验：在客户端封装API调用逻辑时，先检查响应状态码，非成功状态下先判断响应内容格式：

  var response = await httpClient.PostAsJsonAsync("api/xxx", data);
  if (!response.IsSuccessStatusCode)
  {
      var content = await response.Content.ReadAsStringAsync();
      if (content.StartsWith("<"))
      {
          // 处理HTML格式错误，比如记录日志或提示用户服务临时不可用
      }
      else
      {
          // 解析JSON错误信息
      }
  }
  

• 排查服务端稳定性：查看服务器应用池设置，关闭不必要的定时回收，或启用应用预热功能；同时添加端点日志，在Program.cs中开启路由调试日志：

  builder.Logging.AddFilter("Microsoft.AspNetCore.Routing", LogLevel.Debug);
  

  通过日志定位请求实际匹配的端点，找到路由冲突的具体位置。
• 避免路由命名重复：确保API的路由模板（包括控制器名、方法名对应的路由）与Blazor页面路由完全不重复，比如不要让API路由为/user，同时Blazor也有/user页面。

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