InvalidOperationException：无法使用 schemaId .. 相同的 schemaId 已用于类型

Question

我收到以下错误。

InvalidOperationException: Can't use schemaId "$Registration" for type "$PortalService.Models.Registration". The same schemaId is already used for type "$PortalService.Models.Registration"

我已经尝试了以下link中的建议，但没有任何成功。

我在模型中只有一个注册class。我尝试重命名 class 但没有成功。

我正在使用 OData .Net Core 3.1 项目。

下面是配置Swagger

 services.AddTransient<IConfigureOptions<SwaggerGenOptions>, ConfigureSwaggerOptions>();
            services.AddSwaggerGen(c =>
            {
                c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
                {
                    Description = @"JWT Authorization header using the Bearer scheme. \r\n\r\n 
                      Enter 'Bearer' [space] and then your token in the text input below.
                      \r\n\r\nExample: 'Bearer 12345abcdef'",
                    Name = "Authorization",
                    In = ParameterLocation.Header,
                    Type = SecuritySchemeType.ApiKey,
                    Scheme = "Bearer"
                });

                c.AddSecurityRequirement(new OpenApiSecurityRequirement()
                  {
                    {
                      new OpenApiSecurityScheme
                      {
                        Reference = new OpenApiReference
                          {
                            Type = ReferenceType.SecurityScheme,
                            Id = "Bearer"
                          },
                          Scheme = "oauth2",
                          Name = "Bearer",
                          In = ParameterLocation.Header,

                        },
                        new List<string>()
                      }
                    });
            });

使用Swagger如下

  app.UseSwagger(c =>
            {
                //c.PreSerializeFilters.Add((swaggerDoc, httpReq) => swaggerDoc.BasePath = basepath);

                 
                c.PreSerializeFilters.Add((swaggerDoc, httpReq) => {
                    Microsoft.OpenApi.Models.OpenApiPaths paths = new Microsoft.OpenApi.Models.OpenApiPaths();
                    foreach (var path in swaggerDoc.Paths)
                    {
                        paths.Add(path.Key.Replace(path.Key, basepath + path.Key), path.Value);
                    }
                    swaggerDoc.Paths = paths;
                });
            });
            app.UseSwaggerUI(
                options =>
                {
                    options.RoutePrefix = string.Empty;

                    // build a swagger endpoint for each discovered API version

                    foreach (var description in provider.ApiVersionDescriptions)
                    {
                        options.SwaggerEndpoint($"{basepath}/swagger/{description.GroupName}/swagger.json", description.GroupName.ToUpperInvariant());
                    }

                });

这似乎与

有关

我发现如果我从注册中注释掉合作伙伴反向引用，错误就会消失，但我需要这个引用。我不清楚如何解决这个问题。

[ForeignKey("Partner")]
[DataMember(Name = "PartnerOID")]
[Column(TypeName = "VARCHAR(100)")]
public string PartnerOID { get; set; }
//public virtual Partner Partner { get; set; }

Answer 1

试试这个约翰：https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/1607#issuecomment-607170559 帮了我。

我能理解发生了什么；我有几个 'Status' 或 'Type' 的枚举。使用 options.CustomSchemaIds( type => type.ToString() ); 解决了这个问题。

Answer 2

唯一需要更改的是 Startup.cs 方法中的 ConfigureServices。

您应该添加以下内容：

services.AddSwaggerGen(options =>
{
    options.CustomSchemaIds(type => type.ToString());
});

Answer 3

这里有一个稍微灵活一点的方案

options.CustomSchemaIds(type => SwashbuckleSchemaHelper.GetSchemaId(type));

帮手

public static class SwashbuckleSchemaHelper
{
    private static readonly string _rootNamespace;
    private static readonly string _dtoFolder = "Dtos";

    static SwashbuckleSchemaHelper()
    {
        _rootNamespace = Path.GetFileNameWithoutExtension(Assembly.GetExecutingAssembly().ManifestModule.Name);
    }

    private static string GetRelativeNamespace(string typeNamespace)
    {
        if (!typeNamespace.StartsWith(_rootNamespace))
        {
            return typeNamespace;
        }

        var relativenamespace = typeNamespace.Substring(_rootNamespace.Length + _dtoFolder.Length + 1).TrimStart('.');
        if (string.IsNullOrEmpty(relativenamespace))
        {
            return string.Empty;
        }

        return $"{relativenamespace}.";
    }

    public static string GetSchemaId(Type type)
    {
        var schemaBase = $"{GetRelativeNamespace(type.Namespace)}{type.Name}";

        if (type.IsGenericType)
        {
            string? schemaGeneric;
            if (type.GenericTypeArguments.Length > 0)
            {
                var firstItem = type.GenericTypeArguments.First();
                schemaGeneric = $"<{GetRelativeNamespace(firstItem.Namespace)}{firstItem.Name}>";
            }
            else
            {
                schemaGeneric = $"<{Guid.NewGuid()}>";
            }

            return $"{schemaBase}{schemaGeneric}";
        }

        return $"{schemaBase}";
    }
}

InvalidOperationException：无法使用 schemaId .. 相同的 schemaId 已用于类型

InvalidOperationException: Can't use schemaId .. The same schemaId is already used for type

c#

odata

swagger

asp.net-core-3.1