c# - 当类具有循环引用时，Swashbuckle 抛出 StackOverFlow 异常

Question

我有一个像下面这样的 Controller ，在 B 类中有循环引用。

发生这种情况是因为 Swashbuckle 的 jsonserilalizer 设置设置为ReferenceLoopHandling = ReferenceLoopHandling.Error我没有找到任何方法来覆盖此设置。
我在 ASP.NET MVC 应用程序中使用 Swashbuckle 5.6.0。

public class IssueController : ApiController
{
    [HttpGet]
    [Route("A")]
    public A Get(A input)
    {
        return new A();
    }
}

public class A
{
    public virtual B prop1 { get; set; }
}

public class B
{
    public virtual B Parent { get; set; }
}

Answer 1

在我的情况下，事实证明 Stackoverflow 异常不是由 jsonserializer 引起的，而是由上一步引起的(在 json 序列化之前创建 Swashbuckle 模式时)。 Circle References 似乎还不适用于 Swashbuckle(在 Swashbuckle 中，它似乎已修复)。要解决此问题，您必须复制 HandleFromUriParamsRecurseSave并将其(与其他过滤器)添加到操作中:

private static SwaggerDocument BuildSwaggerDocument()
        {
            ...
            var operationFilters = new List<IOperationFilter> {
                new HandleFromUriParamsRecurseSave(20),
                ...
            };
        }

在复制的 HandleFromUriParamsRecurseSave 中，只需添加一个适合您的情况的 maxrecurselength 属性，您就不应该再出现 StackOverflow 错误:

private void ExtractAndAddQueryParams(
      Schema sourceSchema,
      string sourceQualifier,
      bool? sourceRequired,
      SchemaRegistry schemaRegistry,
      ICollection<Parameter> operationParams)
    {
      foreach (var property in sourceSchema.properties)
      {
        ...
          var recurseCount = sourceQualifier.Count(t => t == '.');
          if (schema.@ref != null && recurseCount < _maxRecurseLength)
          {
            ExtractAndAddQueryParams(schemaRegistry.Definitions[schema.@ref.Replace("#/definitions/", "")], sourceQualifier + ToCamelCase(property.Key) + ".", flag, schemaRegistry, operationParams);
          }
          else
          {
            ...
          }
        }
      }
    }

我尝试过的另一种解决方法，但不幸的是没有解决问题，是添加一个堆栈，每次我检测到一个循环时，只添加一次正确的架构定义(也许有人看到了问题):

    private void ExtractAndAddQueryParams(
      Stack<string> sourceSchemaNames,
      Schema sourceSchema,
      string sourceQualifier,
      bool? sourceRequired,
      SchemaRegistry schemaRegistry,
      ICollection<Parameter> operationParams)
    {
      if (sourceSchemaNames.Count > _maxRecurseLength) {
        return;
      }
      foreach (var property in sourceSchema.properties)
      {
        var schema = property.Value;
        var readOnly = schema.readOnly;
        if (readOnly != true)
        {
          var flag = sourceRequired == true && sourceSchema.required != null && sourceSchema.required.Contains(property.Key);
          var recursionDetected = _disableRecursion && sourceSchemaNames.Contains(schema.@ref);
          if (schema.@ref != null && !recursionDetected)
          {
            sourceSchemaNames.Push(schema.@ref);
            ExtractAndAddQueryParams(sourceSchemaNames, schemaRegistry.Definitions[schema.@ref.Replace("#/definitions/", "")], 
              sourceQualifier + ToCamelCase(property.Key) + ".", flag, schemaRegistry, 
              operationParams);
            sourceSchemaNames.Pop();
          }
          else
          {
...
            if (recursionDetected) {
              partialSchema.type = "object";
              partialSchema.@ref = schema.@ref;
            }
            operationParams.Add(partialSchema);
          }
        }
      }
    }
}