🐯 如何完美解决 org.springframework.http.converter.HttpMessageNotReadableException: JSON parse 错误

关于猫头虎

大家好，我是猫头虎，别名猫头虎博主，擅长的技术领域包括云原生、前端、后端、运维和AI。我的博客主要分享技术教程、bug解决思路、开发工具教程、前沿科技资讯、产品评测图文、产品使用体验图文、产品优点推广文稿、产品横测对比文稿，以及线下技术沙龙活动参会体验文稿。内容涵盖云服务产品评测、AI产品横测对比、开发板性能测试和技术报告评测等。

目前，我活跃在CSDN、51CTO、腾讯云开发者社区、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站和小红书等平台，全网拥有超过30万的粉丝，统一IP名称为 猫头虎 或者 猫头虎博主 。希望通过我的分享，帮助大家更好地了解和使用各类技术产品。

• 原创作者： 猫头虎

博主 猫头虎 的技术博客

• 全网搜索关键词： 猫头虎
  了解更多 猫头虎 的编程故事！
• 作者微信号： Libin9iOak
• 作者公众号： 猫头虎技术团队
• 更新日期： 2024年6月16日
  🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能！

专栏链接：

🔗 精选专栏：

• 《面试题大全》 — 面试准备的宝典！
• 《IDEA开发秘籍》 — 提升你的IDEA技能！
• 《100天精通鸿蒙》 — 从Web/安卓到鸿蒙大师！
• 《100天精通Golang（基础入门篇）》 — 踏入Go语言世界的第一步！
• 《100天精通Go语言（精品VIP版）》 — 踏入Go语言世界的第二步！

领域矩阵：

🌐 猫头虎技术领域矩阵：
深入探索各技术领域，发现知识的交汇点。了解更多，请访问：

• 猫头虎技术矩阵
• 新矩阵备用链接

摘要

在Spring Boot项目中，org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error 是一个常见的错误。本博客将详细介绍该错误的原因、解决方案以及最佳实践，帮助开发者在项目中避免和处理此类错误。关键词：Spring Boot，JSON parse error，HttpMessageNotReadableException，异常处理。

在本文中，我们将从零开始，逐步了解并解决 org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error 这一常见问题。

引言

当我们在使用Spring Boot开发RESTful API时，可能会遇到一个令人困扰的问题——org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error。这个错误通常是由于客户端发送的JSON数据格式不正确，导致服务器无法解析。作为一名开发者，掌握如何定位并解决这个错误显得尤为重要。接下来，猫头虎博主将带领大家深入探讨这个问题的成因和解决方法。

正文

1. 错误描述 😱

org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error 是在处理客户端请求时，Spring Boot无法正确解析JSON数据时抛出的异常。以下是一个典型的错误日志示例：

org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `java.util.Date` from String "2021-25-12": not a valid representation (error: Failed to parse Date value '2021-25-12'); nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Cannot deserialize value of type `java.util.Date` from String "2021-25-12": not a valid representation (error: Failed to parse Date value '2021-25-12')

2. 常见原因 📋

2.1 JSON格式错误

当客户端发送的JSON格式不正确时，服务器会抛出该异常。例如，缺少必要的逗号、引号或者大括号。

2.2 数据类型不匹配

JSON中的数据类型与Java对象中的数据类型不一致，例如字符串传递给了日期类型。

2.3 自定义序列化和反序列化问题

自定义序列化和反序列化器可能会导致解析问题，需要确保实现正确。

3. 解决方案 💡

3.1 检查JSON格式

确保客户端发送的JSON格式正确，可以使用在线工具如 JSONLint 验证。

3.2 数据类型校验

确保JSON数据类型与Java对象数据类型匹配，特别是日期、布尔值等特殊类型。

3.3 使用全局异常处理器

通过全局异常处理器捕获并处理该异常，返回友好的错误信息给客户端。

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<String> handleHttpMessageNotReadableException(HttpMessageNotReadableException ex) {
        return new ResponseEntity<>("Invalid JSON format: " + ex.getMessage(), HttpStatus.BAD_REQUEST);
    }
}

3.4 自定义序列化和反序列化器

确保自定义的序列化和反序列化器实现正确，并测试其功能。

public class CustomDateDeserializer extends JsonDeserializer<Date> {

    private SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");

    @Override
    public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
        String date = p.getText();
        try {
            return dateFormat.parse(date);
        } catch (ParseException e) {
            throw new RuntimeException(e);
        }
    }
}

4. QA环节 📚

Q1: 为什么会出现 HttpMessageNotReadableException？

通常是由于客户端发送的JSON格式不正确或数据类型不匹配引起的。

Q2: 如何调试 HttpMessageNotReadableException？

可以通过日志查看详细错误信息，检查客户端发送的JSON数据格式是否正确。

Q3: 如何避免 HttpMessageNotReadableException？

通过严格的数据校验和格式检查，以及使用全局异常处理器来捕获并处理该异常。

小结 🎯

通过以上步骤，我们可以有效地解决 org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error 问题。确保JSON格式正确、数据类型匹配，并使用全局异常处理器和自定义序列化器是解决此问题的关键。

参考资料 📖

• Spring Boot Documentation
• JSONLint
• Jackson Databind

总结 🔚

在Spring Boot项目中，处理 HttpMessageNotReadableException 是开发者必须掌握的一项技能。通过正确的JSON格式、数据类型匹配以及全局异常处理器，我们可以有效避免和解决这个问题，提高项目的健壮性和用户体验。

未来展望 🌟

未来，我们将继续探讨更多Spring Boot中的常见问题和解决方案，帮助大家更好地掌握和应用这一强大的框架。

温馨提示：如果对本文有任何疑问，欢迎点击下方名片，了解更多详细信息！

希望这篇博客能帮助到大家，感谢阅读！🐯

👉 更多信息：有任何疑问或者需要进一步探讨的内容，欢迎点击下方文末名片获取更多信息。我是猫头虎博主，期待与您的交流！ 🦉💬

🚀 技术栈推荐：
GoLang, Git, Docker, Kubernetes, CI/CD, Testing, SQL/NoSQL, gRPC, Cloud, Prometheus, ELK Stack

💡 联系与版权声明：

📩 联系方式：

• 微信: Libin9iOak
• 公众号: 猫头虎技术团队

⚠️ 版权声明：
本文为原创文章，版权归作者所有。未经许可，禁止转载。更多内容请访问猫头虎的博客首页。

点击下方名片，加入猫头虎领域社群矩阵。一起探索科技的未来，共同成长。