LangChain4j工具函数参数类型解析异常问题分析

在LangChain4j框架中，开发者在使用工具函数时可能会遇到一个参数类型解析异常问题。该问题表现为：当工具函数定义中声明了List类型的参数时，实际调用过程中传入的整数值会被错误地解析为Double类型。

问题具体表现为：工具函数定义如下

@Tool("Finds books based on filters...")
String findBooks(
    @P("A filter to find/search books...") String match,
    @P("A JSON array of authors...") List<Integer> authors
) {
    // 实现逻辑
}

当LLM模型调用该工具并传入整数数组参数时，如：

{
    "function": {
        "name": "findBooks",
        "arguments": "{\"arg1\":[123]}"
    }
}

在函数内部接收到的参数值却变成了123.0，即整数被错误地转换为了浮点数。这种类型解析错误会导致后续的业务逻辑处理出现异常。

技术背景分析

这种类型解析问题通常源于JSON反序列化过程中的类型推断机制。在Java生态中，JSON解析器在处理数字类型时，有时会默认将数字统一解析为Double类型，特别是在类型信息不明确的情况下。

解决方案建议

1. 使用基本类型数组替代集合类型：如将List改为int[]，这通常能获得更明确的类型提示

2. 实现自定义的类型解析器：通过注册自定义的JsonDeserializer来确保整数类型的正确解析

3. 在工具函数内部进行类型转换：虽然不够优雅，但可以作为临时解决方案

最佳实践

在使用LangChain4j的工具函数时，建议：

• 优先使用基本类型数组而非集合类型
• 对于复杂参数类型，考虑使用DTO对象包装
• 在关键业务逻辑中添加类型校验
• 保持工具函数的参数类型尽可能简单明确

该问题已在LangChain4j的测试用例中得到确认，开发者可以关注后续版本更新中对此问题的修复。在问题修复前，采用上述解决方案可以避免类型解析错误带来的影响。