快捷導(dǎo)航

MyBatis-Plus實(shí)現(xiàn)優(yōu)雅處理JSON字段映射

更新時間：2025年04月22日 09:06:47 作者：William Dawson

默認(rèn)情況下,MyBatis-Plus 是不支持直接映射 JSON 類型的,這時候就需要借助其他的方法,下面小編就來和大家講講MyBatis-Plus如何優(yōu)雅處理JSON字段映射吧

真實(shí)場景舉例

假設(shè)我們現(xiàn)在有一個旅游美食表 travel_cuisine，里面的字段 tag_list 是一個 JSON Array，用來存儲標(biāo)簽 ID 列表，示例數(shù)據(jù)如下：

["tag-101", "tag-202", "tag-333"]

我們希望在 Java 實(shí)體中使用如下形式自動映射：

@TableField(typeHandler = JsonArrayTypeHandler.class)
private JSONArray tagList;

接下來，教你一步步實(shí)現(xiàn)它。

一、@TableField + typeHandler 是什么？

@TableField 簡介

@TableField 是 MyBatis-Plus 提供的字段級注解，用于說明字段與數(shù)據(jù)庫的映射關(guān)系。

核心參數(shù)如下：

參數(shù)	說明
`value`	對應(yīng)數(shù)據(jù)庫字段名
`exist`	字段是否存在于數(shù)據(jù)庫表結(jié)構(gòu)中
`typeHandler`	字段轉(zhuǎn)換處理器，用于復(fù)雜類型映射

typeHandler 作用

TypeHandler 是 MyBatis 中的一個重要機(jī)制，它負(fù)責(zé)Java 類型和 JDBC 類型之間的轉(zhuǎn)換。

你可以用它來處理：

JSON ↔ Java 對象（如 JSONArray、Map、List）
逗號分隔字符串 ↔ List
枚舉 ↔ 數(shù)據(jù)庫存儲值

簡單來說，typeHandler 就是數(shù)據(jù)格式的橋梁！

二、@TableName(autoResultMap = true) 必須開啟

默認(rèn)情況下，MyBatis-Plus 的字段映射并不會使用 typeHandler，除非你在實(shí)體類加上：

@TableName(value = "travel_cuisine", autoResultMap = true)

autoResultMap 是什么？

這是告訴 MP：“請生成自定義的 ResultMap，否則我不支持 typeHandler 和復(fù)雜類型的轉(zhuǎn)換！”

如果你忘記加這一項(xiàng)，typeHandler 是不會生效的！

三、實(shí)戰(zhàn)代碼：映射 JSON 字段為 JSONArray

1.數(shù)據(jù)庫建表語句（簡化版）

CREATE TABLE travel_cuisine (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(100),
  tag_list TEXT -- JSON Array 字符串
);

2.實(shí)體類配置

@Data
@TableName(value = "travel_cuisine", autoResultMap = true)
public class TravelCuisineDO {

    private Long id;

    private String name;

    @TableField(typeHandler = JsonArrayTypeHandler.class)
    private JSONArray tagList;
}

3.自定義 TypeHandler（基于 FastJSON）

public class JsonArrayTypeHandler extends BaseTypeHandler<JSONArray> {

    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, JSONArray parameter, JdbcType jdbcType) throws SQLException {
        ps.setString(i, parameter.toJSONString());
    }

    @Override
    public JSONArray getNullableResult(ResultSet rs, String columnName) throws SQLException {
        String result = rs.getString(columnName);
        return JSON.parseArray(result);
    }

    @Override
    public JSONArray getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        String result = rs.getString(columnIndex);
        return JSON.parseArray(result);
    }

    @Override
    public JSONArray getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        String result = cs.getString(columnIndex);
        return JSON.parseArray(result);
    }
}

提醒：這個 JsonArrayTypeHandler 使用的是 FastJSON，如需 Jackson，請更換轉(zhuǎn)換邏輯。

四、常見問題排查指南

問題現(xiàn)象	解決方法或建議
typeHandler 沒有生效	檢查實(shí)體類是否開啟 autoResultMap = true
報 JSON parse error	確保數(shù)據(jù)庫字段是真正的 JSON 格式
存儲時字段為 null	確認(rèn)字段不是 transient，且未被忽略
想用 List<String> 代替 JSONArray	寫一個 ListStringTypeHandler 即可

總結(jié)：三件事必須配套使用

配置項(xiàng)	說明
@TableField(typeHandler = …)	標(biāo)記字段轉(zhuǎn)換器
@TableName(autoResultMap = true)	告訴 MP 啟用復(fù)雜映射
自定義 TypeHandler	將 JSON 字段與 Java 類型進(jìn)行互轉(zhuǎn)

到此這篇關(guān)于MyBatis-Plus實(shí)現(xiàn)優(yōu)雅處理JSON字段映射的文章就介紹到這了,更多相關(guān)MyBatis-Plus處理JSON字段映射內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: