You need to enable JavaScript to run this app. Spring Boot JSON反序列化String字段收空数组触发类型不匹配报错
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 15:24:07