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> 
... 

雖然這用來做工精細，因爲HTML不正確呈現了Swashbuckle的一個相當新的更新，而是，我得到呈現爲文本的HTML元素。結果舉例：

清單的答覆多次不起作用。有沒有人爲此提供工作解決方案？

Answer 1

如果它曾經工作，但不再是，它可能是一個問題與Swashbuckle。嘗試使用比您使用的版本更舊的軟件包版本。 （公開）可用的所有版本的列表，請參閱Swashbuckle on NuGet。

如果您發現最新版本確實打破了此功能，請向開發者提出問題。在Github上列出問題的正確位置是：

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