SpringAI报错:com.github.victools.jsonschema.generator.AnnotationHelper

Co0kie_2025-08-14 12:41

问题描述

在使用 Spring AI 进行开发时，结合了Tools程序运行过程中出现了java.lang.ClassNotFoundException: com.github.victools.jsonschema.generator.AnnotationHelper错误。该错误表明 Java 虚拟机（JVM）在尝试加载com.github.victools.jsonschema.generator.AnnotationHelper类时，未能找到其定义，这可能导致相关功能无法正常运行，甚至使应用程序崩溃。如下图所示：

问题原因分析

java.lang.ClassNotFoundException异常通常是由于项目依赖缺失引起的。Spring AI 在处理某些与 JSON Schema 生成相关的功能时，依赖于victools/jsonschema - generator库，而该库未被正确添加到项目的类路径（classpath）中，所以 JVM 无法找到AnnotationHelper类，进而抛出此异常。

解决方案

如果你的项目是基于 Maven 构建的，需要在pom.xml文件中添加victools/jsonschema - generator库的依赖。具体配置如下：

java 复制代码

<dependency>
    <groupId>com.github.victools</groupId>
    <artifactId>jsonschema - generator</artifactId>
    <!-- 可根据实际情况使用最新稳定版本 -->
    <version>4.37.0</version> 
</dependency>