记一次 FastJson 的踩坑经历

  Java大联盟

  帮助万千Java学习者持续成长

关注

项目和第三方对接，有接口一直调不通，直到我拿到合作方的入参后，问题来了，有了接下来的一系列故事。

拿到原生的第三方参数（ JSON 格式的），为了节省时间，迫不及待地直接在本地单元测试一波。熟悉的操作，这里为了方便观察，我模拟一次请求从 Controller 进入的请求：

import com.alibaba.fastjson.JSON;import lombok.Data;


public class ProFastjson {
    @Data
    static class Teacher {
        private String teacherName;
    }


    private static TeacherController teacherController = new TeacherController();


    public static void main(String[] args) {
        String str = "{\"teacher_name\":\"zxerjones\"}";
        Teacher teacher = JSON.parseObject(str, Teacher.class);
        teacherController.search(teacher);
    }
}

看重点：我的 JSONString 参数名有下划线，Teacher 的是没有 teacher_name 这个属性的，反序列化之后的值应该是空的，可偏偏方法走通了。不甘心的我决定 debug 一波，如下图：

反序列化结果

反序列化成功了，是不是一脸懵逼。没错 FASTJson 就是不和你讲道理。行吧，那一定是是 FASTJson 内部的反序列化机制造成这样的结果，debug 进源码看看：

JSON.parseObject 方法内部

注意看上图 378 行，JSON 的反序列化就是在这个方法中实现的，继续跟进：

DefaultJSONParser.parseObject 方法内部

上图对一些规则进行校验之后，开始进入主题。正式调用反序列化工具 JavaBeanDeserializer.deserialze 对字符进行反序列化。这个方法主要做的事情就是对 JSON 字符串内部的键值对和我们需要的反序列化结果类进行绑定，赋值（这个方法代码比较多，只贴重点）：下图是赋值的过程，这才是导致问题的关键：

JavaBeanDeserializer.deserialze 方法内部

就是 850 行代码，终于找到问题的所在了，马上就真相大白。现在可以确定就是 parseField 方法搞的鬼，继续点进去：

parseField 方法内部

上图方法内部做的事情就是生成 field 反序列化工具对 field 反序列化，然后赋值。这个 field 反序列化工具从何而来断点打到 1089 行，可以看到，这个方法返回了我们需要的工具，点进去：

JavaBeanDeserializer.smartMatch 方法内部

代码做的事情就是根据 JSON 字符串的键（teacher_name）做一次 hash 运算，然后与需要反序列化结果（Teacher.class）中的所有参数（这里只有teacherName）做 hash 运算，根据生成的 hash 值来对 field 进行配对。OK就是这样的，现在我们已经找到问题的根源，hash 之后的值是相同的。fastjosn 内部封装了计算 hash 的工具类，TypeUtils.fnv1a_64_lower，如下图：

TypeUtils.fnv1a_64_lower

代码中可以看到进行hash的两个规则：

1、‘-’和‘_’不参与hash运算。

2、忽略大小写。

根据最后得出的 hash 规则，那么可以在 json 字符串中随意的添加"_"，"-"，并且大小写忽略都可以反序列化成功，证实下猜想：如下代码。

 public static void main(String[] args) {        String str = "{\"TEACHER___---NAME\":\"zxerjones\"}";
        Teacher teacher = JSON.parseObject(str, Teacher.class);
        System.out.println(teacher);
    }

运行结果：

ProFastjson.Teacher(teacherName=zxerjones)


Process finished with exit code 0

猜想成立，问题解决。血一样的教训：能用 postman 就不要用单元测试。~~(╯﹏╰)~~

推荐阅读

1、一次性把JVM讲清楚，别再被面试官问住了

2、Spring Boot源码解析

3、一文搞懂前后端分离

4、快速上手Spring Boot+Vue前后端分离

楠哥简介

资深 Java 工程师，微信号 nnsouthwind

《Java零基础实战》一书作者，今日头条认证大V

GitChat认证作者，B站认证UP主（楠哥教你学Java）

致力于帮助万千 Java 学习者持续成长。