ASP.NET Core API版本控制中CreatedAtAction路由匹配失败排查

核心问题 #

你遇到的"No route matches the supplied values"异常，根源是传递给CreatedAtAction的version参数类型不匹配：

• 路由模板里的version是字符串格式的API版本号（比如"1.0"），但你传入的是ApiVersion类型的对象，ASP.NET Core路由系统无法直接将该对象解析为路由所需的字符串值，导致无法匹配到目标GET动作的路由。

修复步骤 #

方案1：将ApiVersion转换为字符串传递 #

修改CreatedAtAction的路由值参数，把ApiVersion对象转为字符串格式：

return CreatedAtAction(
        nameof(GetCarTypeByIdAsync),
        new { version = apiVersion.ToString(), carTypeId = carType.Id },
        carType.ToResponse());

也可以用apiVersion.MajorMinorVersion来获取简洁的版本字符串（比如"1.0"），效果一致。

方案2：使用路由名称生成URL（更可靠） #

因为你已经给GET动作指定了路由名称Name = nameof(GetCarTypeByIdAsync)，可以改用CreatedAtRoute方法直接通过路由名称匹配，避免动作名称匹配的潜在问题：

return CreatedAtRoute(
        nameof(GetCarTypeByIdAsync),
        new { version = apiVersion.ToString(), carTypeId = carType.Id },
        carType.ToResponse());

额外验证点 #

• 确认项目中已正确注册API版本控制服务，比如在Program.cs中添加了：

  builder.Services.AddApiVersioning(options =>
  {
      options.ReportApiVersions = true;
      options.AssumeDefaultVersionWhenUnspecified = true;
      options.DefaultApiVersion = new ApiVersion(1, 0);
  });
  

  确保apiVersion路由约束能正常解析版本号。

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