背景说明

在使用fastjson 1.2.60版本将对象转化为json字符串时，为处理Map值为null的情况，采用了WRITE_MAP_NULL_FEATURES属性，但该属性解析出来的key中缺少双引号，在key包含特殊字符时，如“-”和“:"，下游服务在进行反序列化时出现无法解析的错误，从而出现问题。

Fastjson SerializerFeature介绍

使用fastjson解析为字符串时，需要处理一些特殊情况，比如想要在解析后的字符串中显示对象中为null的字段。这个时候就需要用到fastjson的SerializerFeature序列化属性，有以下几个常用属性：

属性	含义
QuoteFieldNames	输出key时是否使用双引号,默认为true
UseSingleQuotes	使用单引号而不是双引号,默认为false
WriteMapNullValue	是否输出值为null的字段,默认为false
WriteEnumUsingToString	Enum输出name()或者original,默认为false
UseISO8601DateFormat	Date使用ISO8601格式输出，默认为false
WriteNullListAsEmpty	List字段如果为null,输出为[],而非null
WriteNullStringAsEmpty	字符类型字段如果为null,输出为”“,而非null
WriteNullNumberAsZero	数值字段如果为null,输出为0,而非null
WriteNullBooleanAsFalse	Boolean字段如果为null,输出为false,而非null
SkipTransientField	如果是true，类中的Get方法对应的Field是transient，序列化时将会被忽略。默认为true
SortField	按字段名称排序后输出。默认为false
PrettyFormat	结果是否格式化,默认为false
WriteClassName	序列化时写入类型信息，默认为false。反序列化是需用到
DisableCircularReferenceDetect	消除对同一对象循环引用的问题，默认为false
WriteSlashAsSpecial	对斜杠'/'进行转义
BrowserCompatible	将中文都会序列化为uXXXX格式，字节数会多一些，但是能兼容IE 6，默认为false
WriteDateUseDateFormat	全局修改日期格式,默认为false。JSON.DEFFAULT_DATE_FORMAT = "yyyy-MM-dd";JSON.toJSONString(obj, SerializerFeature.WriteDateUseDateFormat);
DisableCheckSpecialChar	一个对象的字符串属性中如果有特殊字符如双引号，将会在转成json时带有反斜杠转移符。如果不需要转义，可以使用这个属性。默认为false

除了上述的属性之外，还有WRITE_MAP_NULL_FEATURES，是以下几个属性的组合：

public static final int WRITE_MAP_NULL_FEATURES
    = WriteMapNullValue.getMask()
    | WriteNullBooleanAsFalse.getMask()
    | WriteNullListAsEmpty.getMask()
    | WriteNullNumberAsZero.getMask()
    | WriteNullStringAsEmpty.getMask()
    ;

fastjson WRITE_MAP_NULL_FEATURES 案列说明

map key不包含特殊字符

public static void main(String[] args) {
        Map<String, Object> map = new HashMap<String, Object>();
        map.put("name", "小明");
        map.put("age", 12);
        map.put("sex", null);
        System.out.println(JSON.toJSONString(map)); // {"name":"小明","age":12}
        System.out.println(JSON.toJSONString(map, SerializerFeature.WriteMapNullValue)); // {"sex":null,"name":"小明","age":12}
        System.out.println(JSON.toJSONString(map, SerializerFeature.WRITE_MAP_NULL_FEATURES)); // {sex:null,name:"小明",age:12}
    }

从上面测试可以看出，使用WRITE_MAP_NULL_FEATURES，输出的json字符串key中并不包含双引号，再进行反序列化测试结果：

public static void main(String[] args) {
        Map<String, Object> map = new HashMap<String, Object>();
        map.put("name", "小明");
        map.put("age", 12);
        map.put("sex", null);
        String test = JSON.toJSONString(map, SerializerFeature.WRITE_MAP_NULL_FEATURES); // {sex:null,name:"小明",age:12}
        JSONObject jsonObject = JSON.parseObject(test);
        System.out.println(JSON.toJSONString(jsonObject)); // {"name":"小明","age":12}
    }

key包含特殊字符（“-” “:”）的反序列化

public static void main(String[] args) {
        Map<String, Object> map = new HashMap<String, Object>();
        map.put("name", "小明");
        map.put("age", 12);
        map.put("sex", null);
        // 包含特殊字符时 "-" 或者 ":"时
        map.put("test:test", "test");
        String test = JSON.toJSONString(map, SerializerFeature.WRITE_MAP_NULL_FEATURES);
        System.out.println(test); // {test-test:"test",sex:null,name:"小明",age:12}
        JSONObject jsonObject = JSON.parseObject(test);
        System.out.println(JSON.toJSONString(jsonObject)); // 抛出异常 com.alibaba.fastjson.JSONException
    }

结论

• 从上面的测试可以看出WRITE_MAP_NULL_FEATURES转化为json字符串时key是不包含双引号的，当key中不存在特殊字符("-"或“:"）时,可以进行正常的反序列化操作，包含了上面的特殊字符时会出现无法解析的异常。
• 另外，对于不带双引号的key，Gson也存在这样的问题，但其可以正常解析含有"-"的特殊字符，无法解析包含":"情况。