带有插入符号的 Swagger UI/Swashbuckle 响应描述未正确呈现

Question

我在 .Net 项目中将 Swashbuckle 与 Swagger UI 结合使用。我在控制器上使用以下属性。

[SwaggerResponse(HttpStatusCode.OK, "IEnumerable<EmployeeModel>", typeof(IEnumerable<EmployeeModel>))]

生成的 JSON 文档产生了这个：

"responses": {
          "200": {
            "description": "IEnumerable<EmployeeModel>",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/ResourceModels.EmployeeModel"
              }
            }
          },
          "400": {
            "description": "BadRequest"
          }
        }

Swagger UI 但是只显示 IEnumerable 并删除 <EmployeeModel>。我确信插入符号是罪魁祸首。有解决办法吗？

Answer 1

根据 Swagger 的说法：

这实际上是描述中的错误。该字段是 gfm，这意味着 <> 中的任何内容都将被视为 html，因此如果您希望这些字符出现，您需要将它们转义。