寻求支持jsonSchemaDialect的OpenAPI校验工具及TS、Java/Kotlin实现

支持jsonSchemaDialect的OpenAPI校验工具 #

• Spectral：完全兼容OpenAPI 3.1规范，能识别并解析jsonSchemaDialect属性，可通过自定义规则集添加对自定义方言关键词的校验逻辑，适合CI流程或本地实时校验场景。
• Redocly OpenAPI CLI：原生支持OpenAPI 3.1全特性，包括jsonSchemaDialect校验，还提供插件机制，允许编写自定义插件处理自定义方言的关键词校验。

TypeScript/JavaScript 实现方案 #

• AJV + openapi-types：AJV是成熟的JSON Schema校验库，支持自定义方言。先用openapi-types解析OpenAPI文档，提取jsonSchemaDialect指定的方言配置，再通过AJV的addMetaSchema方法注册自定义方言，最后添加自定义关键词的校验逻辑。
• @stoplight/spectral-core：作为Spectral的核心库，可直接在TS代码中集成，编写自定义规则校验jsonSchemaDialect关联的方言关键词，同时完成OpenAPI文档的整体结构校验。

Java/Kotlin 实现方案 #

• org.openapi4j：专门针对OpenAPI规范的全功能库，完全支持OpenAPI 3.1的jsonSchemaDialect属性解析，提供扩展点可集成自定义JSON Schema校验器处理方言中的自定义关键词，Kotlin可直接调用该库API。
• Swagger Core（2.2.x及以上）：最新版本已支持OpenAPI 3.1，原生不处理自定义方言，但可通过扩展SchemaValidator接口，自行解析jsonSchemaDialect属性并集成第三方JSON Schema校验库（如Jackson Schema、Everit JSON Schema）实现自定义关键词校验。

内容的提问来源于stack exchange，提问作者hazra