Spring AI项目中Vertex AI Gemini模型JSON解析异常问题解析

在Spring AI项目中使用Vertex AI Gemini模型时，开发者可能会遇到一个常见的JSON解析异常问题。这个问题表现为当模型返回包含数组结构的JSON数据时，系统会抛出"Expect a map object but found array"的错误。

问题背景

该问题主要出现在以下场景：

1. 使用Vertex AI Gemini模型（包括1.5 Flash、2.0 Pro和2.0 Flash等版本）
2. 通过MCP服务器返回包含数组结构的数据（如产品列表）
3. 在Spring AI框架中进行JSON到Protocol Buffers的转换时

错误表现

核心错误信息为：

com.google.protobuf.InvalidProtocolBufferException: Expect a map object but found: [{"text":"{\"products\":...

这表明系统期望接收一个Map类型的对象，但实际接收到的却是一个数组结构。这种类型不匹配导致了解析失败。

技术分析

问题的根本原因在于Vertex AI Gemini模型对JSON结构的处理方式与Spring AI框架的预期存在差异。具体来说：

1. 数据格式要求：Vertex AI的Protocol Buffers转换器严格要求输入必须是Map结构
2. 实际返回数据：MCP服务器返回的Shopify产品数据包含嵌套的数组结构
3. 框架处理流程：Spring AI在将JSON转换为Protocol Buffers时没有对数组结构进行适当处理

解决方案

项目团队已经在新版本中修复了这个问题。开发者可以通过以下方式解决：

1. 升级到最新的Spring AI快照版本
2. 确保使用Gemini 2.0 Flash等较新模型（注意1.5 Flash将在2025年9月停止支持）

最佳实践建议

1. 模型选择：优先使用Gemini 2.0系列模型，它们具有更好的兼容性和更长的支持周期
2. 数据验证：在工具函数返回数据前，确保数据结构符合Vertex AI的要求
3. 错误处理：在客户端代码中添加对JSON解析异常的处理逻辑
4. 版本管理：定期检查Spring AI的更新，及时应用相关修复

这个问题展示了在使用AI服务时数据类型一致性的重要性，也提醒开发者在集成不同系统时要特别注意数据格式的兼容性。