Jackson如何实现不同API中同字段对应不同JSON序列化名称

现有旧API响应结构如下：

{
  "ruleId": "123",
  "ruleName": "Rule1"
}

需要新增一个API，复用完全相同的字段值，但响应字段名替换为id、name，结构如下：

{
  "id": "123",
  "name": "Rule1"
}

改造要求：原有API响应完全不受影响。之前尝试@JsonProperty/@JsonGetter注解，发现这类注解会全局生效，会同步修改原有API的响应结构，需要一套可落地的POJO转JSON序列化方案，支持同一份字段数据输出不同字段名。 #

同字段配置两套序列化规则完全可行，不需要全局修改序列化配置，以下是3种生产环境常用的实现方式，按需选择即可。

方案1：Jackson @JsonView 实现（最推荐，代码侵入最低） #

这个方案可以实现“同字段绑定不同getter，不同接口走不同序列化逻辑”的效果，通过视图标记隔离序列化规则，完全不影响旧接口。

1. 先定义两个空的视图标记接口，用来区分新旧接口的序列化规则：

// 旧API序列化视图
public interface LegacyApiView {}
// 新API序列化视图
public interface NewApiView {}

2. 修改原实体类，给不同视图绑定对应的getter和序列化字段名：

public class Rule {
    private String ruleId;
    private String ruleName;

    // 旧接口序列化时输出ruleId
    @JsonView(LegacyApiView.class)
    @JsonProperty("ruleId")
    public String getRuleId() {
        return ruleId;
    }

    // 新接口序列化时输出id，直接复用ruleId字段值
    @JsonView(NewApiView.class)
    @JsonProperty("id")
    public String getRuleIdForNewApi() {
        return ruleId;
    }

    // 旧接口序列化时输出ruleName
    @JsonView(LegacyApiView.class)
    @JsonProperty("ruleName")
    public String getRuleName() {
        return ruleName;
    }

    // 新接口序列化时输出name，直接复用ruleName字段值
    @JsonView(NewApiView.class)
    @JsonProperty("name")
    public String getRuleNameForNewApi() {
        return ruleName;
    }

    // 原有setter保留不动，反序列化逻辑完全不受影响
    public void setRuleId(String ruleId) {
        this.ruleId = ruleId;
    }
    public void setRuleName(String ruleName) {
        this.ruleName = ruleName;
    }
}

3. 接口层指定对应视图即可，新旧接口完全隔离：

// 旧接口，保持原有返回结构不变
@GetMapping("/legacy/rule")
@JsonView(LegacyApiView.class)
public Rule getLegacyRule() {
    return ruleService.queryRule();
}

// 新接口，返回id+name的新结构
@GetMapping("/new/rule")
@JsonView(NewApiView.class)
public Rule getNewRule() {
    return ruleService.queryRule();
}

注意：如果项目全局配置了默认JsonView规则，一定要给旧接口显式标记LegacyApiView，避免漏出非预期字段。

方案2：定制专用ObjectMapper（零侵入实体类） #

如果不想修改原有实体类的注解，可以单独给新API配置专属的ObjectMapper实例，定制序列化逻辑，和旧接口用的默认ObjectMapper完全隔离。

// 初始化新API专用ObjectMapper，配置Rule类的专属序列化规则
ObjectMapper newApiObjectMapper = new ObjectMapper();
SimpleModule ruleModule = new SimpleModule();
ruleModule.addSerializer(Rule.class, new JsonSerializer<Rule>() {
    @Override
    public void serialize(Rule rule, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeStartObject();
        gen.writeStringField("id", rule.getRuleId());
        gen.writeStringField("name", rule.getRuleName());
        gen.writeEndObject();
    }
});
newApiObjectMapper.registerModule(ruleModule);

旧接口继续用框架默认注入的ObjectMapper，完全不受影响；新接口手动调用newApiObjectMapper.writeValueAsString(rule)生成返回即可。

方案3：专用VO做字段转换（最稳妥，零风险） #

如果对稳定性要求极高，不想动任何序列化配置，直接写一个新接口专用的返回类，做一层手动转换即可，逻辑完全隔离，根本不会有影响旧接口的可能。

// 新接口专用返回VO
public class RuleNewResp {
    private String id;
    private String name;

    // 构造方法直接传入原实体做转换
    public RuleNewResp(Rule rule) {
        this.id = rule.getRuleId();
        this.name = rule.getRuleName();
    }

    // 省略getter、setter
}

新接口直接返回RuleNewResp实例，旧接口还是返回原Rule对象，简单直接，出问题概率为0。 #

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