Swagger UI在模式概述中不显示嵌套字段



我使用Swashbuckle来记录一个带有Swagger-UI的API。我在一些响应中有很多嵌套模型。在页面底部的模式列表中,模式a不允许展开其所有嵌套对象(在某一点上,只显示嵌套对象描述而不是其字段列表),尽管在展开另一个模式B时,在其字段中包含模型a,允许展开a的所有嵌套模式。

这种行为似乎不一致,这是预期的吗?有没有人已经遇到并解决了这个问题?

Thanks in advance

我的经验是生成的YAML/JSON模式是正确的。

,

UI对嵌套模式的显示级别有限制。我猜最大级别设置为2,它似乎是硬编码在渲染器。如果你的模型更深入,UI将只呈现描述,并且示例将以字符串而不是对象生成。

https://github.com/swagger-api/swagger-ui/issues/7437

我很难在可用的文档中找到有关这方面的信息。

还报告了一些问题,例如排序可能导致错误的呈现。https://github.com/swagger-api/swagger-ui/issues/5972

最新更新