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

Question

我在 Swagger API documentation/List 页面上有一个错误。所有调用都正常工作，只是图像细节错误看起来不舒服。当我深入研究错误时，我收到以下 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