c# - Swagger 在 API UI 屏幕上显示错误部分

Question

我在 Swagger API 文档/列表页面上有错误。所有调用都正常工作，只是图像细节错误看起来不舒服。当我深入研究错误时，我收到以下 json 响应:

{"schemaValidationMessages":[{"level":"error","domain":"validation","keyword":"minItems","message":"array is too short: must have at least 1 elements but instance has 0 elements","schema":{"loadingURI":"http://json-schema.org/draft-04/schema#","pointer":"/properties/enum"},"instance":{"pointer":"/definitions/Permissions/properties/permissionType/enum"}}]}

有人遇到过这个问题吗？

Answer 1

Swagger 将始终根据其在线验证器验证您的模式。在您的情况下，根据返回的 JSON，由于 permissionType 枚举没有元素，因此验证失败。如果你真的想要解决这个问题是不可行的，那么你可以使用 Swagger 的 validatorUrl 参数关闭验证 - 参见 this link .如果你想通过 Swashbuckle 做到这一点，你可以使用:

.EnableSwaggerUi(c =>
{
        // Your other config...
        c.DisableValidator();
});

根据 Swashbuckle documentation