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 的问题。尝试使用比您正在使用的版本更旧的软件包版本。

请参阅 NuGet 上的 Swashbuckle，了解所有可用版本（公开）的列表。

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

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

Answer 2

更新，现在可以确认这在 Swashbuckle.AspNetCore 6.5.0 中可以正常工作