招摇错误：架构 ID 冲突：检测到类型 A 和 B 的重复架构 ID

Question

使用Web API和swashbuckle生成swagger文档，我在两个不同的名称空间中定义了两个同名的不同类。当我在浏览器中打开swagger页面时，它显示

冲突的schemaId：为类型A和B检测到重复的schemaID。请参阅配置设置-“UseFullTypeNameInSchemaIds”以了解潜在的解决方法

完整消息：

500:｛“Message”：“发生错误。”，“ExceptionMessage”，“冲突的schemaId：为类型A和B检测到重复的schemaID。”。请参阅配置设置-“UseFullTypeNameInSchemaIds”以了解潜在的解决方法“，”ExceptionType“：”System“。Swashbuckle.Swagger.SchemaRegistry处的InvalidOperationException“，”StackTrace“：”。在Swashbuckle.Swagger.SchemaRegistry处创建RefSchema（类型类型）。在Swashbuckle.Swagger.SchemaRegistry处创建InlineSchema（类型类型）。b_1f（JsonProperty属性）\r\n位于System.Linq.Enumerable。ToDictionary[TSource，TKey，TElement]（IEnumerable＜code＞1个源，Func＜/code＞2个键选择器，Func＞code＞2个元素选择器，IEqualityComparer＜/code＞1个比较器）\r\n位于Swashbuckle.Swagger.SchemaRegistry。Swashbuckle.Swagger.SchemaRegistry处的CreateObjectSchema（JsonObjectContract-jsonContract）\r\n。在Swashbuckle.Swagger.SchemaRegistry处创建定义架构（类型类型）。Swashbuckle.Swagger.Swagger Generator处的GetOrRegister（类型类型）\r\n。Swashbuckle.Swagger.Swagger Generator处的CreateOperation（ApiDescription apiDesc，SchemaRegistry SchemaRegistry）\r\n。Swashbuckle.Swagger.Swagger Generator处的CreatePathItem（IEnumerable＜code＞1 apiDescriptions，SchemaRegistry SchemaRegistry）\r\n。

我不想更改我的班级名称。我该如何修复它？

Answer 1

我正在使用Asp.netCore 2.1。当我试图显示Swagger UI时，会出现此错误。

我是这样解决问题的：

在Starup.cs中，在配置服务（）中添加c.客户模式（i=

参见下面的示例：

services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1", new Info
            {
                Title = "ASP.NET Core 2.1+ ConsumerApp API",
                Version = "v1"
            });
            // Set the comments path for the Swagger JSON and UI.
            var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
            var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
            c.IncludeXmlComments(xmlPath);
            c.CustomSchemaIds(i => i.FullName);
        });

Answer 2

我终于在swagger配置中找到了一种方法。转到App_Start\SwaggerConfig.cs文件并在EnableSwaggerlambda表达式下添加以下行：

c.SchemaId(x => x.FullName);

完整代码是这样的:

GlobalConfiguration.Configuration 
    .EnableSwagger(c =>
    {
        // your configs...

        c.SchemaId(x => x.FullName);

        // other configs...
    })
    .EnableSwaggerUi(c =>
        // ....
    });

Answer 3

招摇的 JSON 中的每个类都必须具有唯一的 schemaId。

Swashbarkler尝试仅将类名用作简单的模式，但是如果您在不同的名称空间中有两个具有相同名称的类（就像您所做的那样），这将不起作用。

正如错误所暗示的那样，您可以使用配置设置“使用FullTypeNameInSchemaIds*”作为潜在的解决方法（更新：在最新版本中不可用）

在较新的版本中，您可以通过选项实现相同的行为。CustomSchemaIds（x =

这里有一个例子:

   services.ConfigureSwaggerGen(options =>
   {
       //your custom configuration goes here

...

  // UseFullTypeNameInSchemaIds replacement for .NET Core
       options.CustomSchemaIds(x => x.FullName);
   });

欲了解更多信息 http://wegotcode.com/microsoft/swagger-fix-for-dotnetcore/