怎么解决JSON.toJSONString()首字母大小写的问题

# 怎么解决JSON.toJSONString()首字母大小写的问题

## 问题背景

在Java开发中，使用`JSON.toJSONString()`方法（如Fastjson、Jackson等库）将对象转换为JSON字符串时，开发者经常会遇到一个典型问题：**生成的JSON字段名首字母被自动转换大小写**。例如：

```java
public class User {
    private String userName;
    // getter/setter
}

// 序列化后可能得到：{"UserName":"Tom"} 而非预期的 {"userName":"Tom"}

这种自动转换可能导致： 1. 与前端约定的字段名不一致 2. 第三方API对接失败 3. 反序列化时字段丢失

原因分析

1. 序列化库的默认命名策略

• Fastjson：默认使用PascalCase（首字母大写）
• Jackson：默认遵循getter方法名（可能因方法命名产生变化）
• Gson：默认保持原始字段名

2. Java Bean规范的影响

部分库会根据getter方法名推导字段名（如getUserName() → UserName）

解决方案

方案一：使用注解显式指定字段名（推荐）

Fastjson

public class User {
    @JSONField(name = "userName")
    private String userName;
}

Jackson

public class User {
    @JsonProperty("userName")
    private String userName;
}

Gson

public class User {
    @SerializedName("userName")
    private String userName;
}

方案二：全局配置命名策略

Fastjson配置

SerializeConfig.getGlobalInstance()
    .propertyNamingStrategy = PropertyNamingStrategy.SnakeCase;

Jackson配置

ObjectMapper mapper = new ObjectMapper();
mapper.setPropertyNamingStrategy(PropertyNamingStrategies.LOWER_CAMEL_CASE);

Gson配置

Gson gson = new GsonBuilder()
    .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
    .create();

方案三：自定义序列化器

适用于需要复杂逻辑控制的场景：

public class CustomSerializer implements ValueSerializer {
    @Override
    public void write(JSONSerializer serializer, Object object) {
        // 自定义序列化逻辑
    }
}

// 注册自定义序列化器
SerializeConfig.getGlobalInstance().put(User.class, new CustomSerializer());

最佳实践

1. 优先使用注解：显式声明字段名可避免歧义

2. 团队统一规范：约定所有API字段使用camelCase

3. 测试验证：通过单元测试检查序列化结果

   @Test
   void testSerialization() {
      User user = new User("Tom");
      String json = JSON.toJSONString(user);
      assertTrue(json.contains("\"userName\""));
   }
   

4. 文档记录：在项目Wiki中记录命名策略

常见问题排查

Q1：注解不生效怎么办？

• 检查是否导入了正确的注解类（如@JSONField属于Fastjson）
• 确认是否使用了正确的序列化库

Q2：如何同时兼容多个序列化库？

public class User {
    @JSONField(name = "userName")
    @JsonProperty("userName")
    private String userName;
}

Q3：第三方类无法修改怎么办？

使用Mix-in模式（Jackson）或自定义TypeAdapter（Gson）

总结

根据项目需求选择合适方案，推荐组合使用注解和全局配置以兼顾灵活性和一致性。 “`