摘要：最近在开发一个Spring Boot项目时，遇到了一个令人头疼的问题：前端传来的JSON参数中使用了单引号，导致后端接口报错。错误信息如下：

问题背景

最近在开发一个Spring Boot项目时，遇到了一个令人头疼的问题：前端传来的JSON参数中使用了单引号，导致后端接口报错。错误信息如下：

这个错误明确告诉我们，Jackson解析器遇到了一个单引号'，而标准的JSON规范要求字符串必须使用双引号"。

问题分析

标准JSON规范

根据JSON规范：

字符串必须用双引号"包围

属性名也必须用双引号"包围

不允许使用单引号'或反引号`

实际开发中的常见情况

虽然标准JSON要求使用双引号，但在实际开发中，我们经常会遇到：

前端开发者习惯使用单引号

某些旧系统或遗留代码使用单引号

从数据库或文件读取的数据可能包含单引号

某些API返回的数据不规范

解决方案

既然不能要求前端修改所有传参，我们就需要在后端进行兼容处理。

方案1：配置Jackson解析器

这是最优雅的解决方案，通过配置Jackson来允许单引号：

方案2：Spring Boot配置

如果你使用的是Spring Boot，可以在application.yml或application.properties中进行配置：

方案3：全局异常处理

为了给前端更友好的错误提示，可以添加全局异常处理：

最佳实践建议

‌优先使用标准JSON格式‌：虽然可以兼容单引号，但最好还是推动团队使用标准格式

‌文档明确要求‌：在API文档中明确要求使用双引号

‌测试覆盖‌：确保测试用例包含非标准JSON的测试场景

‌渐进式改进‌：可以先兼容，再逐步推动格式统一

总结

通过合理配置Jackson解析器，我们可以优雅地解决单引号JSON报错问题。这种方案既保持了系统的稳定性，又避免了要求前端修改传参格式，实现了向后兼容。在实际项目中，建议结合团队实际情况，选择最适合的解决方案。

来源：白腿哥科技讲