.net6中swagger无法识别没有被apicontroller特性标记的控制器

在.NET 6中，Swagger 通常被用来生成API文档。Swagger 通过扫描你的控制器类来识别和描述API端点。在.NET Core 2.1到.NET 5的版本中，Swagger 依赖于`Microsoft.AspNetCore.Mvc.ApiExplorer`来发现和描述API端点。如果你的控制器没有使用`[ApiController]`特性标记，Swagger 可能不会自动识别这些控制器。

为了使Swagger能够识别没有被`[ApiController]`特性标记的控制器，你可以手动配置Swagger来扫描控制器。这通常涉及到在配置Swagger服务时添加额外的步骤。以下是一个简单的配置示例：

public void ConfigureServices(IServiceCollection services)
{
    // 添加API控制器的描述服务
    services.AddControllers();

    // 添加Swagger服务
    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });

        // 获取所有控制器的类型，包括没有标记为[ApiController]的控制器
        var controllerTypes = typeof(Program).Assembly.GetExportedTypes()
            .Where(type => typeof\ControllerBase).IsAssignableFrom(type) && !type.IsAbstract;

        foreach (var controllerType in controllerTypes)
        {
            c.IncludeXmlComments(controllerType.RestControllerXmlCommentFilePath());
            c.AddRouteDescription(controllerType);
        }
    });
}

public static class SwaggerGenServiceExtensions
{
    public static string RestControllerXmlCommentFilePath(this Type type)
    {
        var path = AppContext.BaseDirectory;
        var typeName = type.Name.Replace("Controller", string.Empty);
        return Path.Combine(path, $"{typeName}.xml");
    }
}

在这个配置中，我们使用`services.AddSwaggerGen`来添加Swagger文档，并且遍历了所有继承自`ControllerBase`的类型，包括那些没有使用`[ApiController]`特性的控制器。然后为每个控制器类型手动添加了XML注释文件的路径，这样Swagger就可以读取这些注释来生成更详细的API文档。

记得在使用Swagger之前，你需要安装相关的NuGet包，如`Swashbuckle.AspNetCore`，并确保你的项目中包含正确的XML注释文件。