Swashbuckle 不再正确呈现 HTML Swagger 文档

Question

我的 Web 服务方法由于不同的原因返回相同的 HTTP 响应，例如针对不同质量的发布数据的 400 错误请求。我使用 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 核心。主要版本 6 或更高版本。
• domaindrivendev/Swashbuckle 用于 ASP.NET 4.x。主要版本 5 或更低版本。