使用jackson-module-jsonSchema转换Java类为JSON Schema遇依赖问题求助

我之前在Spring Boot项目里做Java类转JSON Schema的时候，也踩过类似的坑——刚加完jackson-module-jsonSchema依赖就出异常，给你几个实用的排查方向和解决方案：

1. 优先解决版本冲突问题 #

Spring Boot的父POM已经统一管理了Jackson全家桶的版本，如果你手动指定了jackson-module-jsonSchema的版本号，大概率会和Spring Boot自带的Jackson核心依赖（比如jackson-databind）版本不兼容，引发NoClassDefFoundError或者ClassNotFoundException。

解决办法：去掉依赖中的版本号，让Spring Boot自动适配对应版本：

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-jsonSchema</artifactId>
</dependency>

如果必须指定版本，先通过mvn dependency:tree命令查看项目中jackson-databind的版本，确保jackson-module-jsonSchema的版本和它完全一致。

2. 补充必要的核心Jackson依赖 #

如果你的项目不是基于Spring Boot Web Starter（比如纯后端服务、工具类项目），可能缺少Jackson的核心依赖，只加JSON Schema模块会导致运行时异常。

解决办法：添加Jackson核心依赖（如果项目里还没有的话）：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
</dependency>

3. 确保使用正确的Schema生成API #

不同版本的jackson-module-jsonSchema用法有差异，用错API也会触发异常。这里给你一个Spring Boot项目中通用的正确写法：

import com.fasterxml.jackson.databind.JsonMappingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.module.jsonSchema.JsonSchema;
import com.fasterxml.jackson.module.jsonSchema.factories.SchemaFactoryWrapper;

// 生成JSON Schema的示例代码
public class JsonSchemaGenerator {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();
        SchemaFactoryWrapper schemaWrapper = new SchemaFactoryWrapper();
        
        // 传入你要转换的Java类
        mapper.acceptJsonFormatVisitor(mapper.constructType(User.class), schemaWrapper);
        JsonSchema jsonSchema = schemaWrapper.finalSchema();
        
        // 格式化输出Schema
        System.out.println(mapper.writerWithDefaultPrettyPrinter().writeValueAsString(jsonSchema));
    }

    // 示例Java类
    static class User {
        private String username;
        private Integer age;
        // 省略getter/setter
    }
}

另外注意：Jackson 2.10+版本中，jackson-module-jsonSchema已经被标记为过时，官方推荐使用jackson-module-jsonSchema-v2，但如果你的Spring Boot版本较低（比如2.x），还是用旧版本更稳妥。

4. 检查自定义ObjectMapper的配置 #

如果你在Spring Boot中自定义了ObjectMapper的Bean，需要手动注册JsonSchema模块，否则会出现无法生成Schema的异常：

import com.fasterxml.jackson.module.jsonSchema.JsonSchemaModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 注册JSON Schema模块
        mapper.registerModule(new JsonSchemaModule());
        return mapper;
    }
}

如果以上方法都没解决问题，建议把完整的异常栈信息贴出来，这样能更精准地定位问题~

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