Micronaut 2.2.1结合Java 15 record的反序列化异常问题
问题现象
在Micronaut 2.2.1框架项目中,结合Java 15使用record类型定义接口请求模型时,调用/api/v1/product接口触发反序列化失败,接口返回结构化错误信息:
{ "message": "Failed to convert argument [model] for value [null] due to: Cannot construct instance of `view.model.product.ProductViewModel` (no Creators, like default constructor, exist): cannot deserialize from Object value (no delegate- or property-based Creator)\n at [Source: UNKNOWN; line: -1, column: -1]", "path": "/model", "_links": { "self": { "href": "/api/v1/product", "templated": false } } }
报错核心:序列化组件无法实例化
ProductViewModel类,既识别不到可用于反序列化的默认构造器,也找不到匹配字段映射规则的委托/属性式构造器,最终导致参数model转换失败。
涉及业务代码
接口模型定义
使用Java record作为产品视图模型:
public record ProductViewModel ( @Nullable @JsonProperty("id") String id, @Nullable @JsonProperty("name") String name, @Nullable @JsonProperty("description") String description, @Nullable @JsonProperty("price") float price ) { }
控制器接口实现
通过@Body注解直接接收ProductViewModel类型的请求体:
public Single<HttpResponse<?>> Create(@Body ProductViewModel model) { LOG.info(String.format("Controller --> Creating new product")); return iProductManager.Create(model).map(item -> HttpResponse.created(item)); }
问题根因
Micronaut 2.2.1版本默认集成的Jackson序列化组件版本较低,没有内置对Java record类型的构造器识别逻辑。record类型本身不存在无参构造方法,仅保留全字段的标准化构造器,旧版Jackson默认不会将该构造器判定为合法的反序列化入口,因此触发构造器找不到的报错。
可行解决方案
- 升级Micronaut版本至2.5.x及以上分支,该版本起官方默认集成的Jackson版本已完成对record类型的原生适配,无需额外配置即可完成参数映射。
- 若无法升级Micronaut主版本,可单独将项目依赖中的
jackson-databind升级至2.12.0及以上版本,该版本开始Jackson正式支持Java record的反序列化识别。 - 临时适配方案:为
ProductViewModel显式定义全参构造器,在构造器上添加@JsonCreator注解,手动声明该构造器为反序列化入口,配合每个参数上已有的@JsonProperty字段匹配规则,即可让序列化组件正常识别构造逻辑。
内容的提问来源于stack exchange,提问作者San Jaisy
相关产品推荐
相关产品推荐

