Swashbuckle不再正确呈现HTML Swagger文档

Question

我已经获得了Web服务方法，这些方法由于不同的原因返回相同的HTTP响应，例如针对不同质量的发布数据的400 Bad Request。我使用Swashbuckle生成Swagger API文档。

直到最近，我还使用HTML元素来记录响应，以列出相同HTTP响应的不同原因。例如：

...
/// <response code="400"><ul>
///    <li>New member model missing.</li>
///    <li>Account name missing.</li>
///    <li>Password missing.</li>
/// </ul></response>
/// <response code="409"><ul>
///    <li>Data consistency issue.</li>
/// </ul></response>
...

虽然这曾经工作得很好，但由于Swashbuckle的最新更新，HTML不再正确呈现，而是将HTML元素呈现为文本。示例结果：

多次列出响应并不起作用。有没有人为此提供有效的解决方案？

Answer 1

如果它曾经工作但不再工作，那可能是Swashbuckle的一个问题。尝试使用比您正在使用的版本更旧的软件包版本。

有关所有版本（公开）的列表，请参阅Swashbuckle on NuGet。

如果您发现最新版本确实破坏了此功能，请向开发人员提出问题。列出问题的正确位置在Github上：

• domaindrivendev/Swashbuckle.AspNetCore用于ASP.NET Core。主要版本6或更高。
对于ASP.NET 4.x，
• domaindrivendev/Swashbuckle。主要版本5或更低。