如何在Java DTO中将嵌套JSON对象表示为字符串？

你遇到的核心问题很明确：Jackson默认会尝试把JSON中的metadata嵌套对象解析成Java对象（比如Map），但你的DTO里把它定义成了String类型，类型不匹配导致反序列化报错。而且你希望metadata能容纳任意自定义JSON结构，不想为它单独创建Java类，下面给你两种实用的解决方案：

方案一：使用@JsonRawValue + 自定义反序列化器 #

这个方案让Jackson直接把metadata的原始JSON字符串赋值给你的String字段，同时保证序列化时输出的是合法的JSON对象（而非带引号的字符串）。

首先修改你的DTO类，给metadata字段添加注解并指定自定义反序列化器：

@JsonInclude(JsonInclude.Include.NON_NULL)
public class Device {
    private Long id;
    private String manufacturer;
    private String model;
    private Integer profiles;
    
    // 反序列化时转成字符串，序列化时原样输出JSON
    @JsonRawValue
    @JsonDeserialize(using = RawJsonStringDeserializer.class)
    private String metadata;
    
    private List<String> features;

    // 所有getter/setter方法
}

然后创建自定义反序列化器，负责把JSON对象转成字符串：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonNode;
import java.io.IOException;

public class RawJsonStringDeserializer extends JsonDeserializer<String> {
    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.readValueAsTree();
        // 把JSON节点转成紧凑的字符串形式，也可以用toPrettyString()输出格式化后的
        return node.toString();
    }
}

方案二：利用Setter方法接收JsonNode并转字符串 #

如果不想写自定义反序列化器，可以通过修改metadata的setter方法来实现，让Jackson先把嵌套对象转成JsonNode，再手动转成字符串：

@JsonInclude(JsonInclude.Include.NON_NULL)
public class Device {
    private Long id;
    private String manufacturer;
    private String model;
    private Integer profiles;
    private String metadata;
    private List<String> features;

    // 其他字段的getter/setter
    
    // 反序列化时接收JsonNode并转成字符串
    @JsonProperty("metadata")
    public void setMetadata(JsonNode metadata) {
        this.metadata = metadata != null ? metadata.toString() : null;
    }

    // 序列化时输出原始JSON对象，而非带引号的字符串
    @JsonRawValue
    public String getMetadata() {
        return metadata;
    }
}

注意事项 #

• 两种方案都能让你把任意结构的metadata以字符串形式存储到PostgreSQL中，不需要解析成jsonb类型。
• 序列化时@JsonRawValue会保证输出的是合法的JSON对象，前端拿到的结构和原始输入一致，不会是带引号的字符串。
• 如果metadata可能为null，记得处理空值情况，避免空指针异常。

内容的提问来源于stack exchange，提问作者user1920407