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

问题描述

在使用 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库的依赖。具体配置如下：

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