FastJson实战：3种方法搞定Java对象驼峰转下划线命名（附完整代码）

FastJson实战：三种策略优雅解决Java对象驼峰与下划线命名映射难题

在Java后端开发中，与外部系统进行数据交互是家常便饭。无论是调用第三方开放平台的API，还是对接遗留的老系统，一个看似微小却频繁引发“血案”的问题便是命名规范的冲突。我们内部遵循的Java Bean驼峰命名法（如 userName），在对接时常常遭遇对方要求的下划线命名法（如 user_name）。这种不一致会导致序列化后的JSON键名无法匹配，接口调用无声无息地失败，调试起来颇费周章。

今天，我们就深入探讨如何利用国内广泛使用的FastJson库，优雅地化解这一矛盾。本文将不止步于简单的注解使用，而是系统性地为你呈现三种不同维度的解决方案：从最便捷的注解配置，到灵活的手动转换，再到可复用的工具类封装。每种方法都有其适用的场景和权衡，理解其背后的原理，能让你在面对类似问题时，从容选择最合适的“武器”。

1. 理解核心：FastJson的命名转换机制

在动手写代码之前，我们有必要先厘清FastJson处理属性名称的核心逻辑。FastJson默认使用Java对象的属性名（Getter/Setter方法名推导出的属性名）作为序列化后JSON的键名。它本身内置了对几种常见命名风格的支持，关键在于如何配置和触发这些转换规则。

FastJson通过 SerializeConfig 和 ParserConfig 来分别控制序列化（Java对象 -> JSON字符串）和反序列化（JSON字符串 -> Java对象）的行为。其中，命名转换的核心是 NameFilter（序列化时）和 ExtraProcessor 或通过特性（Feature）配置（反序列化时）。

一个常见的误解是认为只需一个开关就能全局搞定。实际上，我们需要根据是单向输出、单向输入还是双向通信来采取不同的策略。下面的表格快速对比了三种场景的核心诉求：

提示：在开始编码前，务必明确你的使用场景属于以上哪一种，这直接决定了后续方案的选择。

理解了这些，我们就可以进入实战环节了。我们将从最符合Spring Boot等现代框架习惯的注解方案开始。

2. 方案一：注解驱动——声明式的优雅转换

对于大多数项目，尤其是使用了Spring MVC框架的，注解方案因其声明式、无侵入的特性而备受青睐。FastJson提供了 @JSONField 注解，它可以精确地控制单个字段的序列化行为。

2.1 基础注解用法

假设我们有一个用户信息对象 UserDTO，需要与一个要求下划线命名的外部接口对接。

import com.alibaba.fastjson.annotation.JSONField;

public class UserDTO {
    private Long userId;
    private String userName;
    private String emailAddress;

    // 使用@JSONField注解的name属性指定序列化后的名称
    @JSONField(name = "user_id")
    public Long getUserId() {
        return userId;
    }
    public void setUserId(Long userId) {
        this.userId = userId;
    }

    @JSONField(name = "user_name")
    public String getUserName() {
        return userName;
    }
    public void setUserName(String userName) {
        this.userName = userName;
    }

    @JSONField(name = "email_address")
    public String getEmailAddress() {
        return emailAddress;
    }
    public void setEmailAddress(String emailAddress) {
        this.emailAddress = emailAddress;
    }
}

使用这个对象进行序列化：

UserDTO user = new UserDTO();
user.setUserId(1L);
user.setUserName("张三");
user.setEmailAddress("zhangsan@example.com");

String jsonString = JSON.toJSONString(user);
System.out.println(jsonString);

输出结果将是：

{"email_address":"zhangsan@example.com",