Solon-AI 项目中的 JSON 属性下划线转驼峰命名问题解析

Solon-AI 项目中的 JSON 属性下划线转驼峰命名问题解析

【免费下载链接】solon-ai Java AI & MCP 应用开发框架（LLM，Function Call，RAG，Embedding，Reranking，Flow，MCP Server，Mcp Client，Mcp Proxy）。同时兼容 java8 ~ java24。也可嵌入到 SpringBoot2、jFinal、Vert.x 等框架中使用。 项目地址: https://gitcode.com/opensolon/solon-ai

在 Solon-AI 项目开发过程中，开发者遇到了一个关于 JSON 属性命名转换的典型问题。当使用 POST 请求并通过 @Body 注解传递 JSON 参数时，JsonProperty 注解未能正确实现下划线命名到驼峰命名的转换。

问题现象

开发者定义了一个接收文件上传信息的接口，DTO 类中使用 @JsonProperty 注解期望将 JSON 中的下划线命名（如 file_title）自动转换为 Java 类的驼峰命名属性（如 fileTitle）。然而实际测试发现，当传入 {"file_title": "123456"} 这样的 JSON 数据时，后端无法正确映射到对应的 Java 属性。

问题根源

经过分析，这个问题主要由以下两种可能性导致：

1. 项目缺少必要的 JSON 序列化插件（如 solon-serialization-jackson）
2. 项目中同时存在多个 JSON 序列化实现导致冲突

解决方案

针对这个问题，最有效的解决方法是：

1. 确保项目中引入了正确的 JSON 序列化依赖（solon-serialization-jackson）
2. 排除可能存在的冲突依赖（如 solon-web 自带的序列化组件）

具体实现方式是在项目的构建配置文件中排除冲突的依赖项，确保只有一个 JSON 序列化实现生效。

技术原理

在 Java Web 开发中，JSON 数据的序列化和反序列化是一个常见需求。Solon 框架支持通过插件机制来实现不同的序列化方案。当存在多个序列化实现时，可能会导致行为不一致或功能冲突。

JsonProperty 注解通常由 Jackson 库提供支持，它能够处理 JSON 属性名与 Java 属性名之间的映射关系。要实现下划线命名到驼峰命名的自动转换，需要确保：

1. 正确配置了 Jackson 的命名策略
2. 项目中只有一个 Jackson 实现处于激活状态
3. 没有其他序列化库干扰 Jackson 的正常工作

最佳实践

对于 Solon-AI 这类项目，建议采用以下实践来避免类似问题：

1. 明确声明所需的 JSON 序列化依赖
2. 定期检查依赖冲突
3. 在关键数据类上使用明确的命名注解
4. 编写单元测试验证序列化/反序列化行为

通过这种方式，可以确保 JSON 数据处理的一致性和可靠性，为 AI 服务的稳定运行提供基础保障。

【免费下载链接】solon-ai Java AI & MCP 应用开发框架（LLM，Function Call，RAG，Embedding，Reranking，Flow，MCP Server，Mcp Client，Mcp Proxy）。同时兼容 java8 ~ java24。也可嵌入到 SpringBoot2、jFinal、Vert.x 等框架中使用。 项目地址: https://gitcode.com/opensolon/solon-ai