Spring Boot JSON反序列化String字段收空数组触发类型不匹配报错
异常成因
- Jackson反序列化默认采用严格的类型匹配规则:当后端
IdiomaNoticia类的conteudo、titulo、resumo字段定义为String类型时,解析器仅认可JSON中的字符串值(包括null)作为合法输入 - 构造的请求体中,
noticiaDTOs数组后两个元素的对应字段传入了空数组[],JSON解析时识别到代表数组结构开始的START_ARRAY令牌,与预期的字符串类型令牌完全不兼容,直接抛出MismatchedInputException - 核心矛盾是前后端对空值的传参约定不统一:后端预期空值场景传
null或空字符串,前端错误使用空数组[]作为空占位
可行解决方案
方案1:修正前端传参逻辑(优先推荐)
- 调整前端请求构造规则,对所有后端定义为字符串类型的字段,空值场景统一传
null或空字符串"",禁止用空数组作为占位值 - 该方案完全符合接口类型约定,无需改动后端代码,从根源上消除类型不匹配问题
方案2:后端增加空数组兼容适配
如果前端无法快速调整传参,可在后端侧做兼容处理:
- 针对
IdiomaNoticia类中三个冲突的字段,自定义Jackson反序列化逻辑:当解析到值为空数组[]时,自动转换为null或空字符串;如果解析到非空数组结构,抛出明确的参数校验提示 - 不建议直接全局开启Jackson的宽松反序列化配置,该配置会放开所有String类型字段的类型校验,容易掩盖其他潜在的传参错误
方案3:调整字段类型适配多格式传参(不推荐)
- 如果多端传参完全不统一,字段需要同时兼容字符串、字符串数组两类格式,可以将字段类型从
String调整为Object,在业务逻辑层做类型判断与转换 - 该方案会丢失原有DTO层的类型校验能力,需要在业务层编写大量分支判断逻辑,后续维护成本极高,仅适合特殊历史遗留场景
内容的提问来源于stack exchange,提问作者Bruno Bittencourt
相关产品推荐
相关产品推荐

