如何解决 .JsonParseException: Unexpected character ('<' (code 60)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false')

在开发过程中，处理 JSON 数据时遇到 JsonParseException 错误是非常常见的。尤其是以下这种错误提示：

.JsonParseException: Unexpected character ('<' (code 60)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false')
复制

这个错误通常出现在你尝试解析一个 JSON 数据时，数据的格式不符合预期。具体来说，这个错误说明在解析过程中，遇到了一个 < 字符，这通常意味着你期望解析一个有效的 JSON 数据（如字符串、数字、数组、对象等），但实际上得到的是 HTML 页面或者错误信息。

---

作者简介

猫头虎是谁？

大家好，我是 猫头虎，猫头虎技术团队创始人，也被大家称为猫哥。我目前是COC北京城市开发者社区主理人、COC西安城市开发者社区主理人，以及云原生开发者社区主理人，在多个技术领域如云原生、前端、后端、运维和AI都具备丰富经验。

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用方法、前沿科技资讯、产品评测、产品使用体验，以及产品优缺点分析、横向对比、技术沙龙参会体验等。我的分享聚焦于云服务产品评测、AI产品对比、开发板性能测试和技术报告。

目前，我活跃在CSDN、51CTO、腾讯云、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站、小红书等平台，全网粉丝已超过30万。我所有平台的IP名称统一为猫头虎或猫头虎技术团队。

我希望通过我的分享，帮助大家更好地掌握和使用各种技术产品，提升开发效率与体验。

---

作者名片 ✍️

• 博主：猫头虎
• 全网搜索关键词：猫头虎
• 作者微信号：Libin9iOak
• 作者公众号：猫头虎技术团队
• 更新日期：2025年03月20日
• 🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能！

---

加入我们AI共创团队 🌐

• 猫头虎AI共创社群矩阵列表：
  • 点我进入共创社群矩阵入口
  • 点我进入新矩阵备用链接入口

加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀

部分专栏链接：

🔗 精选专栏：

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

---

正文

错误原因

这个错误通常发生在以下几种场景：

1. 错误的 URL 或 API 响应：你可能请求了一个 API 或加载了一个 URL，预期返回的是 JSON 数据，但实际返回的是 HTML（可能是一个错误页面）。HTML 页面通常会包含 < 字符，因此导致了解析错误。
2. 服务器返回 HTML 错误信息：如果服务器在遇到错误时返回了 HTML 格式的错误页面，而你仍然尝试将其解析为 JSON 数据，也会遇到这个错误。
3. 网络问题：网络中断或请求超时等问题可能导致返回的不是预期的 JSON，而是一个 HTML 页面，包含 < 字符。

解决方案

为了修复这个问题，我们可以采取以下几种方法来确保正确处理 JSON 数据。

1. 检查 API 响应

首先，确认你请求的 URL 或 API 确实返回 JSON 数据。你可以通过以下方式进行验证：

• 手动检查响应：使用浏览器或者工具（如 Postman）访问 API，查看返回的内容是不是 JSON 格式。若返回 HTML 页面，说明 API 出现问题。
• 查看响应头：确保响应头中的 Content-Type 为 application/json，这可以帮助你判断服务器返回的数据类型。

2. 添加错误处理机制

确保你在解析 JSON 数据时，添加适当的错误处理机制，以防万一遇到非预期的响应格式。可以通过捕获异常来处理这种情况：

try {
    String jsonResponse = getApiResponse();  // 假设这是获取 API 响应的代码
    JSONObject jsonObject = new JSONObject(jsonResponse);  // 解析 JSON
} catch (JsonParseException e) {
    System.out.println("JSON 解析错误: " + e.getMessage());
    // 处理错误或打印出更多的错误信息
} catch (Exception e) {
    System.out.println("其他错误: " + e.getMessage());
    // 其他错误处理
}
复制

通过这种方式，你可以捕获和记录错误，避免程序崩溃，同时让用户知道发生了什么。

3. 调试与日志记录

启用日志记录可以帮助你分析发生错误的原因，尤其是在请求过程中。如果你使用的是某些框架（例如 Spring），可以启用 HTTP 请求和响应的日志记录，以便查看请求的实际内容。

// 在 Spring 中，可以通过拦截器来记录请求和响应的详细信息
public class LoggingInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("Request URL: " + request.getRequestURL());
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("Response Status: " + response.getStatus());
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 可以记录响应内容
    }
}
复制

4. 使用条件判断

如果你不确定返回的数据类型，可以首先检查返回的内容，判断是否为 JSON 格式。如果不是，可以选择跳过解析或者尝试其他的处理方法。

if (jsonResponse.startsWith("{") || jsonResponse.startsWith("[")) {
    // 如果数据以 '{' 或 '[' 开头，说明是 JSON 数据
    try {
        JSONObject jsonObject = new JSONObject(jsonResponse);
    } catch (JsonParseException e) {
        // 处理解析错误
    }
} else {
    // 如果不是 JSON 数据，进行相应处理
    System.out.println("返回的数据不是 JSON 格式");
}
复制

5. 检查网络请求

如果你怀疑问题是由网络连接问题引起的（例如，超时或中断导致的 HTML 错误页面），可以检查你的网络请求设置，确保它们在请求失败时进行适当的重试或超时处理。

RequestConfig requestConfig = RequestConfig.custom()
    .setConnectTimeout(5000)  // 设置连接超时
    .setSocketTimeout(5000)   // 设置读取超时
    .build();
CloseableHttpClient httpClient = HttpClients.custom().setDefaultRequestConfig(requestConfig).build();
复制

总结

JsonParseException: Unexpected character ('<' (code 60)) 错误通常是因为服务器返回了 HTML 页面，而你期望的是 JSON 格式的数据。通过检查 API 响应、增加错误处理、启用日志记录和检查网络请求，可以有效地解决这个问题。最重要的是在开发过程中保持灵活性和健壮性，确保对可能发生的各种错误做出合适的处理。

粉丝福利

---

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

---

联系我与版权声明 📩

• 联系方式：
  • 微信: Libin9iOak
  • 公众号: 猫头虎技术团队
• 版权声明：
  本文为原创文章，版权归作者所有。未经许可，禁止转载。更多内容请访问猫头虎的博客首页。

---

点击✨⬇️下方名片⬇️✨，加入猫头虎AI共创社群矩阵。一起探索科技的未来，共同成长。🚀