使用aspnet-api-versioning库配置API文档时出现错误

我经常帮开发者排查aspnet-api-versioning的配置问题，结合你提供的信息，给你梳理几个常见的出错点和解决办法：

• 确认NuGet包版本兼容：务必保证你安装的Microsoft.AspNet.WebApi.Versioning包和项目的ASP.NET Web API版本匹配。比如Web API 2项目要对应正确的包主版本，版本不匹配很容易引发初始化或编译错误。
• 补全配置代码：你贴出的代码片段是截断的（var jsonFormatter = co...），要确保完整实现了核心配置步骤。最基础的API版本注册代码不能少：

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

  如果需要API版本的文档支持，还要添加版本化API Explorer的配置，别遗漏关键代码段。
• 核对命名空间引用：确认你引用的是Microsoft.Web.Http.Versioning——这是ASP.NET Web API（非Core）对应的版本ing命名空间，别和ASP.NET Core的版本ing命名空间混淆，否则会出现找不到类型或方法的错误。
• 排查过滤器冲突：你的代码里引入了自定义ActionFilters，要检查这些过滤器有没有修改请求管道或路由规则，避免和API版本ing的逻辑冲突，导致版本识别失效。
• 定位具体错误：如果是编译错误，仔细看错误提示里的命名空间、方法是否存在；如果是运行时错误，查看应用日志的异常栈，通常能找到比如依赖缺失、路由配置不兼容等具体问题。

这里给你一个完整的WebApiConfig配置示例，你可以对比自己的代码查漏补缺：

namespace Nppg.WebApi {
    using Microsoft.Web.Http.Versioning;
    using Nppg.WebApi.ActionFilters;
    using System.Web.Http;

    public static class WebApiConfig {
        public static void Register(HttpConfiguration config) {
            // 核心API版本配置
            config.AddApiVersioning(options =>
            {
                options.ReportApiVersions = true;
                options.AssumeDefaultVersionWhenUnspecified = true;
                options.DefaultApiVersion = new ApiVersion(1, 0);
            });

            // 版本化API Explorer配置（用于文档生成）
            config.AddVersionedApiExplorer(options =>
            {
                options.GroupNameFormat = "'v'VVV";
                options.SubstituteApiVersionInUrl = true;
            });

            // JSON格式化器完整配置
            var jsonFormatter = config.Formatters.JsonFormatter;
            jsonFormatter.SerializerSettings.ContractResolver = 
                new Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver();

            // 属性路由配置
            config.MapHttpAttributeRoutes();

            // 常规路由配置（带版本参数）
            config.Routes.MapHttpRoute(
                name: "DefaultApi",
                routeTemplate: "api/{version}/{controller}/{id}",
                defaults: new { id = RouteParameter.Optional }
            );
        }
    }
}

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