c# - 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 核心。主要版本 6 或更高版本。
• domaindrivendev/Swashbuckle对于 ASP.NET 4.x。主要版本 5 或更低版本。