Fastjson2中public修饰符与首字母大写字段的序列化问题解析

问题背景

在Java开发中，Fastjson2作为一款高性能的JSON处理库，被广泛应用于对象与JSON字符串之间的转换。近期发现了一个关于字段命名和访问修饰符的特殊情况：当类中的字段使用public修饰符且首字母大写时，Fastjson2在序列化过程中会出现重复key的问题。

问题现象

考虑以下Java类定义：

public class Param {
    public String UserName;  // public修饰且首字母大写
    String Code;             // 默认访问修饰符
    String Sort;
    String Status;
    
    // 省略getter/setter
    
    public static void main(String[] args) {
        Param param = new Param();
        param.setUserName("张三");
        param.setCode("001");
        param.setSort("1");
        param.setStatus("正常");
        System.out.println("json: " + JSON.toJSONString(param));
    }
}

当执行上述代码时，生成的JSON字符串中会出现重复的key，特别是对于public修饰且首字母大写的字段（如UserName）。

技术原理分析

Fastjson2在序列化过程中会同时考虑字段和方法两种途径：

1. 字段序列化：对于public修饰的字段，Fastjson2会直接访问并序列化
2. 方法序列化：Fastjson2会查找对应的getter方法（遵循JavaBean规范）进行序列化

当字段命名不符合标准驼峰命名规范（如UserName而不是userName）时，Fastjson2会：

• 通过字段访问得到一个key（如"UserName"）
• 通过getter方法访问得到另一个key（如"userName"）

这就导致了JSON结果中出现重复key的问题。

解决方案演进

临时解决方案

在Fastjson2 2.0.54版本之前，开发者可以采用以下两种临时方案：

1. 使用@JSONField注解：明确指定字段的序列化名称

@JSONField(name = "UserName")
public String UserName;

2. 修改字段命名：遵循标准的驼峰命名规范

public String userName;

官方修复方案

Fastjson2开发团队在2.0.54版本中修复了这一问题。新版本优化了序列化逻辑，确保即使字段使用public修饰且首字母大写，也不会产生重复key。修复后的版本能够正确处理以下情况：

• 保持原始字段名的大小写形式
• 避免通过字段和方法双重访问导致的重复序列化
• 兼容各种命名规范的字段

最佳实践建议

1. 遵循JavaBean规范：尽量使用标准的驼峰命名法（如userName）定义字段
2. 谨慎使用public字段：除非必要，否则避免将字段直接声明为public
3. 版本选择：建议使用Fastjson2 2.0.54或更高版本，以获得更稳定的序列化行为
4. 注解使用：对于特殊命名需求，优先考虑使用@JSONField注解明确指定序列化名称

总结

Fastjson2作为高性能JSON库，在不断演进中优化了各种边界情况的处理。这次public修饰符与首字母大写字段的序列化问题修复，体现了开发团队对细节的关注。开发者应当了解JSON序列化的基本原理，并在实际开发中遵循良好的编码规范，以避免类似问题的发生。对于无法修改的第三方SDK中的类，升级到最新版本的Fastjson2是最可靠的解决方案。