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"}}]}

有人遇到过这个问题吗？

- TheAkhemist

Answer 1

Swagger将始终对您的模式进行在线验证。在您的情况下，由于JSON返回中的permissionType枚举没有元素，因此验证失败。如果您真的想这么做并且修复问题不可行，则可以使用Swagger的validatorUrl参数关闭验证-请参见此链接。如果您希望通过Swashbuckle进行此操作，则可以使用以下方法：

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

根据Swashbuckle文档，

- strickt01