.NET WebAPI项目Swagger正常运行但无API端点显示问题

我之前也碰到过类似的情况，结合你提供的代码细节，整理了几个针对性的排查和解决方向：

1. 确保Swagger正确扫描控制器所在程序集 #

默认Swashbuckle会扫描SwaggerConfig所在的程序集，但有时候需要显式配置避免遗漏。修改你的SwaggerConfig，在EnableSwagger中补充扫描相关的配置：

GlobalConfiguration.Configuration
    .EnableSwagger(c => {
        c.SingleApiVersion("v1", "Backend.WebApi");
        // 显式指定要扫描的控制器程序集（如果控制器和SwaggerConfig同程序集也可以加，确保扫描覆盖）
        c.IncludeAssemblies(typeof(TestController).Assembly);
        // 解决路由冲突（如果存在的话）
        c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
        // 如果需要加载XML注释，添加下面的配置和辅助方法
        c.IncludeXmlComments(GetXmlCommentsPath());
    })
    .EnableSwaggerUi(c => { });

如果要启用XML注释，补充这个辅助方法到SwaggerConfig类中：

private static string GetXmlCommentsPath()
{
    // 这里的XML文件名要和项目生成的XML文档文件名一致
    return $@"{System.AppDomain.CurrentDomain.BaseDirectory}\Backend.WebApi.XML";
}

别忘了在项目属性→生成→输出里勾选“XML文档文件”，确保输出路径和上面代码中的路径匹配。

2. 调整Swagger注册的顺序 #

在WebApiConfig中，Swagger的注册应该放在路由配置完成之后，这样它才能读取到完整的路由信息。修改你的WebApiConfig顺序：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 先配置服务相关
        AutoMapperConfiguration.Configure();
        ConfigureIoC(config);

        // 再配置Web API路由
        config.MapHttpAttributeRoutes();
        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );

        // 最后注册Swagger
        SwaggerConfig.Register();

        // JSON格式化配置保持不变
        var jsonFormatter = config.Formatters.OfType<JsonMediaTypeFormatter>().First();
        jsonFormatter.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();
    }
}

3. 排查[Authorize]属性的影响 #

你的控制器加了[Authorize]属性，虽然默认Swagger会列出需要授权的端点，但如果没有配置Swagger的身份验证支持，有时候可能会出现端点不显示的情况（概率较低，但可以排查）。你可以先临时移除[Authorize]，重启项目看端点是否出现：

• 如果出现了，再给Swagger添加身份验证配置，比如支持Bearer令牌：

.EnableSwaggerUi(c => {
    c.EnableOAuth2Support(
        clientId: "",
        clientSecret: "",
        realm: "Backend.WebApi",
        appName: "Backend.WebApi"
    );
})

4. 检查控制器和方法的访问修饰符 #

确认所有需要暴露的控制器和API方法都是public修饰的——你的示例代码里TestController和GetVehicles都是public的，这部分没问题，但可以检查其他控制器是否有遗漏。

5. 验证Swashbuckle版本兼容性 #

如果你使用的是较旧的Swashbuckle.Core版本（因为你是.NET Framework的WebAPI），可能存在配置差异。尝试把Swashbuckle更新到最新的稳定版本，或者对照对应版本的官方文档检查配置。

做完以上调整后，重启项目，再访问Swagger页面，同时查看http://localhost:62536/swagger/docs/v1的返回内容，如果paths字段里出现了你的API路由，就说明问题解决了。

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