WebAPI出现「需指定API版本但未指定」错误，相关代码排查求助

让我们一步步拆解你遇到的问题，从你提供的代码片段来看，主要有几个关键点需要修正：

1. 默认版本配置缺失关键项 #

你已经设置了AssumeDefaultVersionWhenUnspecified = true，但没有明确指定DefaultApiVersion——这就好比你告诉系统"如果没指定版本就用默认的"，但没说默认版本到底是哪个。系统自然会报错要求指定版本。

修正配置代码，补充默认版本：

config.AddApiVersioning(o => 
{
    o.AssumeDefaultVersionWhenUnspecified = true;
    o.DefaultApiVersion = new ApiVersion(2, 0); // 替换成你实际需要的默认版本，比如1.0
});

2. 无版本路由的版本关联问题 #

你的控制器里有一个全局路由[Route("~/api/ger/getDetail")]，这个路径没有包含版本参数。当请求这个地址时，系统无法自动关联到对应的API版本，即使开启了默认版本，也需要确保这个action能被正确识别。

可以给这个action单独标记版本（如果它属于某个特定版本）：

[ApiVersion("2.0")]
[Route("~/api/ger/getDetail")]
[Route("getDetail")]
public IHttpActionResult GetGerData()
{
    // 你的业务代码
}

或者如果希望它继承控制器的版本，确保控制器的ApiVersion标记是完整有效的。

3. 不完整的ApiVersion定义 #

你代码里出现了[ApiVersion("1...，这明显是未写完的版本标记。API版本需要是有效的格式，比如具体版本[ApiVersion("1.0")]、多版本[ApiVersion("1.0"), ApiVersion("2.0")]，或者带弃用标记[ApiVersion("1.0", Deprecated = true)]。不完整的版本定义会导致版本解析失败，触发错误。

4. 路由约束的匹配验证 #

控制器的RoutePrefix是"api/v{version:apiVersion}/ger"，这里的apiVersion约束会校验版本格式的有效性。测试时可以先尝试访问带版本的路径（比如api/v2.0/ger/getDetail），确认版本路由是否正常工作，再测试无版本的路径，验证默认版本是否生效。

按照以上步骤修正后，应该就能解决「An API version is required, but was not specified.」的错误了。

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