fastjson序列化对象空值不处理,使用JSON.toJSONString中序列化空字符串遇到的坑

博主： admin
发布时间：2024 年 08 月 26 日
849 次浏览
11 条评论
3104字数
分类： java

# FastJSON 使用注意事项：`JSON.toJSONString` 与 Null 值处理

**FastJSON** 是由阿里巴巴开源的一套高性能 JSON 处理器。相较于其他 JSON 处理器（如 Gson、Jackson）以及 Java 原生的序列化/反序列化方式，FastJSON 在性能上通常具有显著优势。

## 使用 `JSON.toJSONString` 的注意事项

### 1. Null 值属性的默认行为（潜在的“坑”）

*   **现象：** 当使用 `JSON.toJSONString` 将一个 Java 对象转换为 JSON 字符串时，如果该对象的某些属性值为 `null`，**FastJSON 默认会将这些属性从生成的 JSON 字符串中完全过滤掉（即不包含对应的 key）**。
*   **示例：** 假设一个对象有三个属性 `a`, `b`, `c`，其中 `a=1`, `b="hello"`, `c=null`。默认情况下，转换后的 JSON 字符串会是 `{"a":1,"b":"hello"}`，属性 `c` 及其 `null` 值会被省略。
*   **潜在问题：** 这种默认行为在某些场景下可能不符合预期（例如，需要明确区分 `null` 和字段不存在，或者下游系统要求完整的字段结构）。

### 2. 生成 JSON 字符串的两种主要方式

FastJSON 提供了两种核心方法将对象转换为 JSON 字符串：

1.  **`JSON.toJSONString(Object object)`**
    *   这是最常用的静态方法。
    *   直接作用于目标对象。
2.  **`JSONObject.toJSONString(Object object)`**
    *   通过 `JSONObject` 的静态方法实现。
    *   功能上与 `JSON.toJSONString` 基本相同。通常更推荐直接使用 `JSON.toJSONString`。

### 3. 控制 Null 值输出的序列化特性

FastJSON 提供了特定的 `SerializerFeature` 来控制 `null` 值的序列化行为，避免其被默认过滤：

*   **`SerializerFeature.WriteMapNullValue`**
    *   **作用：** **强制输出值为 `null` 的字段。**
    *   **效果：** 值为 `null` 的属性会以 `key: null` 的形式出现在 JSON 字符串中。
    *   **适用场景：** 适用于所有类型的 `null` 值（对象、数组、字符串、数字等）。
    *   **用法示例：**
        ```java
        Map<String, Object> map = new HashMap<>();
        map.put("a", 1);
        map.put("b", "hello");
        map.put("c", null);
        String jsonString = JSON.toJSONString(map, SerializerFeature.WriteMapNullValue);
        // 结果: {"a":1,"b":"hello","c":null}
        ```

*   **`SerializerFeature.WriteNullStringAsEmpty`**
    *   **作用：** **将值为 `null` 的字符串 (`String`) 字段序列化为空字符串 `""`。**
    *   **效果：** 值为 `null` 的 `String` 类型属性会输出为 `key: ""`。
    *   **适用场景：** **仅针对 `String` 类型**。其他类型的 `null` 值（如 `Integer`, `List` 等）不会被处理（默认仍可能被过滤，除非同时使用 `WriteMapNullValue`）。
    *   **用法示例：**
        ```java
        public class Message {
            private Integer id;
            private String content; // String 类型
            // getters & setters
        }
        Message msg = new Message();
        msg.setId(1);
        msg.setContent(null); // content 是 String 且为 null
        String jsonString = JSON.toJSONString(msg, SerializerFeature.WriteNullStringAsEmpty);
        // 结果: {"id":1,"content":""}  (注意 content 是空字符串)
        ```

### 关键区别与选择

*   **`WriteMapNullValue`:** 保留所有 `null` 字段，显式输出为 `null`。适用于需要明确表示字段存在但值为空的场景。
*   **`WriteNullStringAsEmpty`:** **仅**将 `String` 类型的 `null` 转换为空字符串 `""`。适用于特定要求字符串字段不能为 `null` 而必须是空字符串的场景。**它不影响非 `String` 类型的 `null` 值。**

### 注意事项

*   如果需要处理**非 `String` 类型**的 `null` 值（如 `Integer`, `Boolean`, 自定义对象等），必须使用 `WriteMapNullValue`。
*   可以同时传递多个 `SerializerFeature`：
    ```java
    JSON.toJSONString(obj, SerializerFeature.WriteMapNullValue, SerializerFeature.WriteNullStringAsEmpty, ...);
    ```
*   如果同时使用 `WriteMapNullValue` 和 `WriteNullStringAsEmpty`：
    *   对于 `String` 类型的 `null` 值，会应用 `WriteNullStringAsEmpty`，输出为 `""`。
    *   对于其他类型的 `null` 值，会应用 `WriteMapNullValue`，输出为 `null`。
*   可以通过配置 `JSON.DEFAULT_GENERATE_FEATURE` 来修改全局默认的序列化特性（包含 `WriteMapNullValue`），但这会影响所有未显式指定特性的序列化操作，需谨慎使用。

最后修改：2025 年 06 月 05 日

如果觉得我的文章对你有用，请随意赞赏

11 条评论

itxsgxrqup
October 7th, 2025 at 08:03 pm

2025年10月新盘做第一批吃螃蟹的人coinsrore.com
新车新盘嘎嘎稳嘎嘎靠谱coinsrore.com
新车首发，新的一年，只带想赚米的人coinsrore.com
新盘上车集合留下我要发发立马进裙coinsrore.com
做了几十年的项目我总结了最好的一个盘（纯干货）coinsrore.com
新车上路，只带前10个人coinsrore.com
新盘首开新盘首开征召客户！！！coinsrore.com
新项目准备上线，寻找志同道合的合作伙伴coinsrore.com
新车即将上线真正的项目，期待你的参与coinsrore.com
新盘新项目，不再等待，现在就是最佳上车机会！coinsrore.com
新盘新盘这个月刚上新盘新车第一个吃螃蟹！coinsrore.com

回复
zzlzlzdhlz
October 6th, 2025 at 09:57 pm

新盘上车集合留下我要发发立马进裙

回复
oykvbgrobq
March 2nd, 2025 at 11:11 am

文献引用规范，学术态度严谨，值得借鉴。

回复
564494
February 15th, 2025 at 01:42 pm

https://www.bilibili.com/opus/521971043391297398
https://www.cnblogs.com/bluestorm/p/18405840
https://zhuanlan.zhihu.com/p/9780381446
解决方法是 sudo nano /etc/default/grub 加入一行 GRUB_DISABLE_OS_PROBER="false"
sudo grub-mkconfig -o /boot/grub/grub.cfg
https://nosomber.github.io/2024/05/15/archinstall/
https://www.163.com/dy/article/HTIBB6B90511CPOJ.html

回复
123123
February 15th, 2025 at 01:39 pm

https://www.bilibili.com/video/BV1KM4m1R7Jn/?vd_source=da17cc3cedcac84c9b2856f2cfbd8c86

回复
2222
February 14th, 2025 at 10:07 pm

sudo pacman -S nvidia-driver # 对于NVIDIA显卡

回复
11111
February 13th, 2025 at 11:50 pm

https://yaijlmydbvj.feishu.cn/wiki/YVuJw146WiJQvbkAIuncx6VanZR?fromScene=spaceOverview

回复
111
February 13th, 2025 at 11:48 pm

https://blog.csdn.net/m0_47670683/article/details/113793200

回复
qdxpmjcbng
November 30th, 2024 at 09:24 pm

《谁偷了我的DNA》科幻片高清在线免费观看：https://www.jgz518.com/xingkong/44686.html

回复
mpdpbhtfdj
November 16th, 2024 at 08:31 pm

揭秘传奇私服制作网站的幕后黑手与非法产业链：https://501h.com/jinbi/2024-10-15/42494.html

回复
rjpafskduu
September 23rd, 2024 at 09:27 am

看的我热血沸腾啊

回复