mysql json mybatis plus

### 如何使用 MyBatis Plus 操作 MySQL 中的 JSON 字段 #### 使用场景理解 JSON 数据结构因其灵活性被广泛应用于现代应用程序中，尤其是在存储半结构化数据方面表现出色。对于采用 MyBatis-Plus (MP) 的项目来说，在处理这类数据时需考虑其特殊性[^1]。 #### 版本兼容性注意 值得注意的是，MySQL 自 5.7.8 起引入了对 JSON 类型的支持，并且在后续版本如 MySQL 8 上有更优的表现。因此，在着手开发前确认所使用的数据库版本至关重要[^2]。 #### 解决中文字符乱码问题 当遇到读取 JSON 字段中的中文字符显示异常的情况时，应重点排查 `mysql-connector-java` 驱动程序的版本。较低版本可能存在编码解析上的缺陷；例如，6.0.3 版本曾报告过此类问题，而升级到至少 6.0.6 可有效规避该错误[^3]。 #### 实现方法概述 为了使 MP 正确识别并操作 JSON 格式的列，可以采取如下策略： ##### 定义实体类属性映射 通过自定义转换器或利用现有的 Jackson 库实现 Java 对象与 JSON 文本之间的相互转化。这通常涉及到设置合适的 getter 和 setter 方法以及标注相应的注解来指示哪些字段应当按照 JSON 方式序列化/反序列化。 ```java import com.alibaba.fastjson.JSONObject; import com.baomidou.mybatisplus.annotation.TableField; public class ExampleEntity { @TableField(typeHandler = FastjsonTypeHandler.class) private JSONObject jsonData; } ``` ##### 注册 TypeHandler 创建一个继承自 BaseTypeHandler<T> 的处理器用于指定如何将给定的对象转储成 SQL 参数值或是从 ResultSet 提取出对应的结果集条目。这里推荐使用 fastjson 或 jackson 这样的第三方库来进行高效的 JSON 处理。 ```java import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import com.alibaba.fastjson.JSON; import java.sql.CallableStatement; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; public class FastjsonTypeHandler extends BaseTypeHandler<JSONObject> { @Override public void setNonNullParameter(PreparedStatement ps, int i, JSONObject parameter, JdbcType jdbcType) throws SQLException { ps.setString(i, JSON.toJSONString(parameter)); } @Override public JSONObject getNullableResult(ResultSet rs, String columnName) throws SQLException { return JSON.parseObject(rs.getString(columnName)); } @Override public JSONObject getNullableResult(ResultSet rs, int columnIndex) throws SQLException { return JSON.parseObject(rs.getString(columnIndex)); } @Override public JSONObject getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { return JSON.parseObject(cs.getString(columnIndex)); } } ``` ##### 更新 mybatis-config.xml 文件 最后一步是在全局配置文件里注册上述 type handler，以便在整个应用范围内生效。 ```xml <typeHandlers> <typeHandler javaType="com.alibaba.fastjson.JSONObject" handler="your.package.FastjsonTypeHandler"/> </typeHandlers> ``` 以上即为基于 MyBatis-Plus 框架下针对 MySQL JSON 字段的一般解决方案[^4]。