You need to enable JavaScript to run this app. Micronaut 2.2.1结合Java 15 record的反序列化异常问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.14 01:15:04