Fastjson2 JSON.parseObject 方法中数组解析问题分析

问题背景

在Fastjson2项目中，从2.0.55版本开始出现了一个关于JSON数组解析的行为变化。当使用JSON.parseObject方法将包含数组的JSON字符串反序列化为Java对象时，数组的方括号会被意外丢失。

问题重现

考虑以下测试用例：

public static void main(String[] args) {
    String jsonStr = "{\"file\":[{\"url\":\"http\"}]}";
    Bbb result = JSON.parseObject(jsonStr, Bbb.class);
    System.out.println(result);
}

@Data
static class Bbb {
    String file;
}

在Fastjson2不同版本中的输出结果：

• 2.0.53版本输出：Test.Bbb(file=[{"url":"http"}])
• 2.0.54版本输出：Test.Bbb(file=[{"url":"http"}])
• 2.0.55版本输出：Test.Bbb(file={"url":"http"})
• 2.0.56版本输出：Test.Bbb(file={"url":"http"})

技术分析

这个问题的本质在于Fastjson2在2.0.55版本中对JSON数组解析逻辑的修改。当目标字段被声明为String类型时，Fastjson2内部对数组的处理方式发生了变化：

1. 在2.0.54及之前版本，Fastjson2会保留数组的完整结构，包括方括号
2. 从2.0.55版本开始，Fastjson2会去掉数组的方括号，只保留数组中的内容

这种变化导致了与之前版本的不兼容行为，特别是在以下场景会受到影响：

1. 当JSON数据中包含数组结构
2. 目标字段被声明为String类型
3. 业务逻辑依赖于数组结构的完整性

解决方案

Fastjson2开发团队已经确认这是一个不合理的改动，并在2.0.57版本中恢复了2.0.54之前的行为。这意味着：

1. 数组结构将被完整保留
2. 方括号不会被移除
3. 与旧版本保持兼容

最佳实践建议

1. 对于需要处理JSON数组的场景，建议明确指定目标类型为集合类型（如List）而非String
2. 升级到Fastjson2 2.0.57或更高版本以获得正确的数组处理行为
3. 在反序列化时，考虑使用更具体的类型而非通用String类型，以获得更好的类型安全性和数据完整性

总结

Fastjson2在2.0.55-2.0.56版本中引入的数组解析行为变化是一个不合理的改动，可能导致依赖数组结构完整性的应用出现问题。开发团队已在2.0.57版本中修复此问题，恢复了与之前版本一致的行为。开发者应当注意版本兼容性问题，并在升级时进行充分的测试验证。