Spring AI工具调用中空参数问题的分析与解决方案

问题背景

在使用Spring AI框架进行工具调用时，开发者可能会遇到"toolInput cannot be null or empty"的错误。这个问题特别容易出现在流式调用(stream)模式下，而同样的代码在普通调用(call)模式下却能正常工作。

问题现象

当开发者使用Spring AI的ChatClient进行流式工具调用时，系统会抛出IllegalArgumentException异常，提示"toolInput cannot be null or empty"。这个错误发生在MethodToolCallback.call方法中，当工具方法被调用时，Spring框架会检查输入参数是否为空。

根本原因分析

经过深入分析，我们发现这个问题的根源在于：

1. 当LLM(大语言模型)调用无参数的工具方法时，实际上会传递一个null值作为输入
2. Spring AI框架的MethodToolCallback会严格执行参数非空检查
3. 这种检查在流式调用模式下表现得更为严格，导致异常被抛出

解决方案

临时解决方案

目前最直接的解决方案是在工具方法中添加一个虚拟参数(dummy parameter)：

@Tool(description = "Get the system time.")
String getTime(String dummy) {
    return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date());
}

这样做的原因是：

1. 即使LLM传递null值，方法签名也能匹配
2. 虚拟参数可以吸收null值，避免空指针异常
3. 不影响工具方法的实际功能

长期解决方案

从框架设计角度，更优雅的解决方案应该是：

1. 在工具调用拦截层处理null值
2. 自动将null转换为空字符串或默认JSON对象
3. 或者修改框架的校验逻辑，允许无参数工具调用

开发者可以自定义ToolCallback实现，在调用实际工具方法前进行参数预处理：

public class NullSafeToolCallback implements ToolCallback {
    private final ToolCallback delegate;
    
    @Override
    public String call(String toolInput) {
        if(toolInput == null) {
            toolInput = "{}"; // 转换为空JSON对象
        }
        return delegate.call(toolInput);
    }
    // 其他方法实现...
}

最佳实践建议

1. 对于无参数工具方法，始终添加虚拟参数
2. 在工具方法内部做好空值防御
3. 考虑使用Optional类型包装可能为空的参数
4. 对于关键业务工具，实现自定义的参数校验逻辑

总结

Spring AI框架在工具调用方面提供了强大的功能，但在参数处理上还有一些边界情况需要考虑。通过本文介绍的方法，开发者可以有效地解决工具调用中的空参数问题，确保应用的稳定性和可靠性。随着Spring AI框架的持续发展，我们期待官方能够提供更完善的参数处理机制。