Blazor客户端调用API时首字符为数字的GUID触发ArgumentNullException异常

你遇到的异常本质是反序列化得到的IEnumerable<Stage>为null，后续代码对其执行Linq操作时触发了ArgumentNullException。null的根源是服务端API路由没有匹配成功，返回了空响应/404响应，导致GetStreamAsync拿到空流，反序列化结果为空。

以数字开头的GUID匹配失败的具体原因有两类：

• 路由隐式类型推断问题：你没有给路由参数显式指定类型约束时，ASP.NET Core路由系统会优先尝试把以数字开头的路径段解析为数值类型，匹配失败后就不会转发到你写的GetAllStage接口。以字母开头的GUID不会触发数值解析逻辑，所以可以正常匹配。
• 静态文件中间件拦截：部分部署环境（如IIS托管、配置了单页应用回退规则）下，以数字开头的路径段会被误判定为静态文件请求，直接被静态文件中间件拦截，没有进入接口处理流程。

你可以通过浏览器开发者工具的网络面板查看对应请求的状态码，如果返回404即可确认是路由匹配问题。

方案1：显式添加路由类型约束（优先推荐） #

直接在服务端路由上指定参数类型，彻底避免隐式类型推断问题。
如果参数是字符串类型：

[HttpGet("{id:string}")]
public IActionResult GetAllStage(string id)
{
    return Ok(_stageRepository.GetAllStagesById(id));
}

如果确定入参一定是GUID，直接用Guid类型接收更安全：

[HttpGet("{id:guid}")]
public IActionResult GetAllStage(Guid id)
{
    // 可直接将仓储方法入参改为Guid类型，避免字符串转换
    return Ok(_stageRepository.GetAllStagesById(id.ToString()));
}

方案2：调整中间件注册顺序 #

如果排查后确认是静态文件中间件拦截了请求，将控制器路由注册逻辑放到静态文件处理之前即可：

var builder = WebApplication.CreateBuilder(args);
// 省略其他服务注册逻辑
var app = builder.Build();

// 先注册控制器路由，优先处理接口请求
app.MapControllers();
// 再处理静态文件请求
app.UseStaticFiles();

// 省略其他中间件配置
app.Run();

方案3：统一控制器路由前缀 #

给整个Stage控制器添加统一的路由前缀，避免和其他路由规则冲突：

[Route("api/[controller]")]
[ApiController]
public class StageController : ControllerBase
{
    [HttpGet("{id}")]
    public IActionResult GetAllStage(string id)
    {
        return Ok(_stageRepository.GetAllStagesById(id));
    }
}

客户端直接按原有规则请求api/stage/{id}即可，不需要额外拼接字符。

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