SwashBuggler.swaggerDocument无法创建文档

问题描述 投票:-1回答:1

项目结构:

  1. 控制台应用程序-启动WebAPI启动
  2. API Project(DLL)-仅配置(使用(AssemblyPart)进行容器和授权以及控制器类的初始化]
  3. ControllerClass(DLL)-具有API方法

SwaggerDocumentaion配置,ConfigureService类代码:

    services.AddSwaggerGen(options =>
        {
            options.DescribeAllEnumsAsStrings();
            options.SwaggerDoc("v1", new Swashbuckle.AspNetCore.Swagger.Info
            {
                Title = "TestAPI",
                Version = "v1",
                Description = "TestApplication API for modular monolith .NET application.",
            });

            var baseDirectory = AppDomain.CurrentDomain.BaseDirectory;
            var commentsFileName = "Test.Modules.UserAccess.Facade.XML";//Assembly.GetExecutingAssembly().GetName().Name + ".XML";
            var commentsFile = Path.Combine(baseDirectory, commentsFileName);
            options.IncludeXmlComments(commentsFile);

            var securityToken = new Dictionary<string, IEnumerable<string>>
            {
                {"Bearer", new string[] { }},
            };

            options.AddSecurityDefinition("Bearer", new ApiKeyScheme
            {
                Description = "JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"",
                Name = "Authorization",
                In = "header",
                Type = "apiKey"
            });
            options.AddSecurityRequirement(securityToken);
        });

配置类别:

 public void Configure(IApplicationBuilder app, IHostingEnvironment env, IServiceProvider 
  serviceProvider)
    {
        app.UseSwagger();
        app.UseSwaggerUI(c =>
        {
            c.SwaggerEndpoint("/swagger/v1/swagger.json", "TestAPI");
            c.RoutePrefix = string.Empty;

        });
    }

我已经生成XML文件并复制到输出目录。

问题:

我收到错误“无法加载API定义”。帮助我解决此问题。

c# swagger asp.net-core-2.1 swashbuckle
1个回答
0
投票

您可以仔细检查Controller方法吗?例如,Swagger需要明确的[HttpPost][HttpGet]如果具有Get(int id)Post(..),则将返回“无法加载API定义”>

© www.soinside.com 2019 - 2024. All rights reserved.