模型中使用 JToken 时 Swagger Schema 自引用

Question

我的 API 模型有一个类似于 JArray 类型的属性

public class MyModel
{
   public JArray Credentials { get; set; }
   public string Property1 {get;set;}
}

对于 Credentials Swagger 生成类似

"credentials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/JToken"
            },
            "nullable": true
          }

模式就像

 "JToken": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/JToken"
        }
      }

这里JToken是自引用的，如何避免这种自引用呢？

Answer 1

在生成 Swagger 文档时映射 JToken 的类型，如下所示解决了自引用问题

services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
                c.MapType<JToken>(() => new OpenApiSchema { Type = typeof(JToken).Name });
            });