Blazor WASM API调用突然失效，重命名方法后恢复是什么原因？

问题根因分析 #

你Postman拿到的是Blazor WASM的首页HTML，说明请求没有匹配到任何服务端API路由，触发了你配置的路由回退规则（MapFallbackToFile("index.html")），直接返回了前端页面。

第一个明显错误：请求路径写错 #

你控制器类名是ItemController，ASP.NET Core 中[controller]路由占位符会自动去掉类名末尾的Controller后缀，所以正确的API前缀是/Item而非/ItemController，你Postman请求的/ItemController/GetAllItems本身就是错误路径，先把路径修正为localhost:44383/Item/GetAllItems再测试。

为什么原方法名突然失效、改名后恢复 #

常见可触发该现象的原因有以下几种：

• 增量编译异常：Visual Studio的增量编译偶尔会出现构建不完整的问题，更新后的控制器路由没有写入最新的程序集，导致服务端路由表还是旧的内容。你修改方法名后触发了完整编译，路由表更新后就可以正常匹配，直到下一次增量编译出错导致另一个方法路由失效。
• 路由冲突/优先级被抢占：如果你近期新增了其他控制器、属性路由或通配符路由，新路由的匹配优先级高于原Item/GetAllItems路由，请求会被新路由提前拦截。修改方法名后，原路由不再匹配前置的冲突路由，就可以正常落到目标Action上。
• 路由缓存问题：如果你的服务端开启了路由缓存，或者浏览器/代理有旧的路由缓存规则，会导致特定路径的请求被错误转发。

排查步骤 #

1. 清理项目缓存：关闭Visual Studio，删除整个解决方案下所有项目的bin、obj文件夹，重新全量生成解决方案，排除增量编译问题。
2. 开启路由调试日志：在服务端的appsettings.json中添加路由日志配置：

{
  "Logging": {
    "LogLevel": {
      "Microsoft.AspNetCore.Routing": "Debug"
    }
  }
}

调试时查看控制台输出的路由匹配过程，可以直接看到请求具体匹配到了哪条规则、为什么没有落到目标Action上。
3. 检查近期新增的代码：重点看最近两周新增的中间件、控制器、路由配置，有没有拦截/Item前缀路径，或者存在相同路由模板的其他Action。
4. 检查Action重复定义：确认同一个控制器内没有同名的GetAllItems方法，即使参数不同，没有明确的路由约束的情况下也会导致路由匹配冲突。

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