当前位置：首页 > news >正文

MyBatis 类型处理器（TypeHandler）注册与映射机制：JsonListTypeHandler和JsonListTypeHandler注册时机

news 来源：原创 2025/6/13 15:09:34

下面几种机制会让你的 List<String>/Map<String,?> 能正确读写成 JSON 数组／对象文本：

MyBatis-Plus 自动注册
最新版本的 MyBatis-Plus starter 会把类路径下所有带 @MappedTypes({List.class})、@MappedJdbcTypes(JdbcType.VARCHAR) 这类注解的 TypeHandler 自动注册进 TypeHandlerRegistry，所以即使你不在 ConfigurationCustomizer 里再手动 registry.register(...)，MyBatis-Plus 启动时也会把它们扫描进来。
字段注解强制指定
如果你的实体里写了

@TableField(typeHandler = JsonListTypeHandler.class) private List<String> skills;

那 MyBatis 在构建映射的时候会直接 new 这个 JsonListTypeHandler 来处理该字段，不会再走默认的 StringTypeHandler。
JDBC 驱动的容错
就算真没有任何自定义 Handler，JDBC 驱动也会把你传进去的字符串（比如你在 Mapper XML 里写 #{skills}，skills.toString() 恰好是 ["a","b"]）原封不动地当 VARCHAR 存到 DB，当你再查回 String 字段时，就能看到 JSON 文本。

所以你看到“即使把那两行全局注册删掉，也能正常上传／查询”，并不奇怪：

MyBatis-Plus Starter 在后台已经给你注册好了 List/Map 的 JSON 处理器；
你要么在实体里用注解显式选了 Handler，要么 DB 和驱动自己把字符串存下来了。

如果你真想验证“到底哪条路径在生效”，可以：

断点调试 JsonListTypeHandler#setNonNullParameter(...)
直接看看在执行插入/更新时，MyBatis 到底走的是哪个 Handler 的方法。
临时写个 ConfigurationCustomizer 打日志

@Bean public ConfigurationCustomizer customizer() { return config -> { config.getTypeHandlerRegistry() .getTypeHandler(List.class) .ifPresent(h -> System.out.println("List 类型处理器是：" + h.getClass())); }; }

启动后控制台能看到到底用的哪个 Handler。

核心原理回顾

@MappedTypes 注解
在类上打了 @MappedTypes(List.class) 或 @MappedTypes(Map.class)，MyBatis-Plus Starter 在启动时会扫描并 自动注册 这些类型处理器。
- 如果你的版本里这个自动扫描没开，就算有 @MappedTypes，MyBatis 也不会加载它，你就必须在 ConfigurationCustomizer 里手动 registry.register(...)。
字段级别指定
如果你在实体类字段上写了

@TableField(typeHandler = JsonListTypeHandler.class) private List<String> skills;

那就算全局没注册，MyBatis 也会给该字段硬绑定到这个 handler 上。
MyBatis-Plus 内置 JSON 处理器
新版本里，MP 自带了基于 Jackson 的 JacksonTypeHandler，它也会给带 @MappedTypes 的类自动装上。
所以你如果单纯删掉全局注册，MP 可能已经自己把 JsonListTypeHandler／JsonMapTypeHandler 扫进去了，看起来就“好像不用注册也行”了。

为什么你“以前删掉会报错”？

旧版本 的 MP Starter 并不自动扫描你自己写的 JsonListTypeHandler，也没给 List.class 或 Map.class 任何默认 handler。
这时，插入或查询带 List<String> 字段，就会抛错：

Type handler was null for parameter List
你就逼不得已在 ConfigurationCustomizer 里手动注册，或者在字段上加 @TableField(typeHandler=…)，才跑通。

现在为啥又“删了也能正常”？

升级后，MP 已经把所有带 @MappedTypes 注解的 handler 自动扫描并注册 了；
或者你给字段加了 @TableField(typeHandler=…)，绕过了全局注册需求；
又或者你的表里该列其实是 VARCHAR／TEXT，你直接在 service 里手动 JSON.toString(list) 存，插入成功——但是反查时就只能拿到 String。

建议

保留你的 Handler 类，毕竟它能让你自动在实体里写 List<String>／Map<String,?>。
如果想最简化，全局注册可以删，但要确保你的 MP Starter 版本 ≥ 3.5 且内置扫描打开：

mybatis-plus: type-handlers-package: com.example.chat2.handler
或者在每个 JSON 字段上写：

@TableField(typeHandler = JsonListTypeHandler.class) private List<String> skills;

这样就算全局没扫到，也能按字段绑定。

小结

JsonListTypeHandler/JsonMapTypeHandler 本身是你项目必需的，只是注册方式可以有三条路：
1. 全局 ConfigurationCustomizer 手动注册
2. @MappedTypes + MP 自动扫描
3. 字段上 @TableField(typeHandler=…)
你“以前没写注册就报错”是因为那会儿自动扫描没开；现在自动扫描打开了，注册看似“多余”了，但在老版本或没有字段注解的情况下，它依然是必不可少的。

希望理清了为什么「看着好像多余」又「删掉又会报错」的来龙去脉！

而我是在xml写了这个

MyBatis 会直接按照你指定的 typeHandler 来做序列化／反序列化，这种方式和在 Java 里用 @MappedTypes 或者在全局注册处理器是等价的——它们都是最终把 JSON 文本和 List<String> 对象挂钩。

是XML 显式覆盖
在 <resultMap> 或 <select> 的 <result> 里写 typeHandler="..."，MyBatis 在映射这个列的时候，跳过默认的类型推断，直接 new 指定的 JsonListTypeHandler。

不再依赖自动扫描
无需再借助 @MappedTypes、type-handlers-package 或者 ConfigurationCustomizer 全局注册，都能保证该字段走你想要的 Handler。

清晰直观
只要看 XML 就知道哪些列要走 JSON 处理，不会被其他配置“隐式”影响。

何时用哪种方式？

方式	优点	缺点
XML 中 `typeHandler`	最直观，按字段精确控制；不依赖额外扫描	每个字段都得在 XML 定义一次，比较啰嗦
字段注解 `@TableField(typeHandler=…)`	配置集中在实体类；配合 MP 自动生成也能生效	如果你写 XML，而是用 MP 的 Wrapper/注解方式，则需要这样，XML 与注解混用时可能有重复
全局自动扫描（`@MappedTypes` + Starter 或者 `ConfigurationCustomizer`）	一次注册，全表所有 `List`/`Map` 列自动生效	控制粒度粗，所有同类型字段都会走同一个 Handler

小贴士
如果你只在少数几个字段用 JSON，XML 显式是最简单可靠的方式；

如果全项目大量用到，建议用全局扫描或者字段注解，免得 XML 太长；

切勿同时对同一个字段在 XML、注解和全局注册里都写不同的 Handler，否则会有优先级混乱的问题。

MyBatis 类型处理器（TypeHandler）注册与映射机制：JsonListTypeHandler和JsonListTypeHandler注册时机

下面几种机制会让你的 List<String>/Map<String,?> 能正确读写成 JSON 数组／对象文本： MyBatis-Plus 自动注册最新版本的 MyBatis-Plus starter 会把类路径下所有带 MappedTypes({List.class})、MappedJdbcTypes(JdbcType.VARCHAR) 这类注…...

编程日记 2025/5/16 13:09:14

Spark SQL开发实战：从IDEA环境搭建到UDF/UDAF自定义函数实现

利用IDEA开发Spark-SQL 1、创建子模块Spark-SQL，并添加依赖 <dependency> <groupId>org.apache.spark</groupId> <artifactId>spark-sql_2.12</artifactId> <version>3.0.0</version> </dependency> 3…...

编程日记 2025/5/25 6:03:40

神经网络笔记 - 神经网络

一.神经网络基础知识 1.神经网络解决了什么问题将人类眼中的数据（如图像、文本）转换成计算机能理解的特征矩阵。适用于分类、回归等多种任务，本质上是进行特征提取与决策映射。 2.神经网络基本结构输入层（Input Layer&#x…...

编程日记 2025/5/16 12:22:24

C20-breakcontinue

一 break break的作用:用于跳出当前的循环 #include <stdio.h> int main() {//变量初始化int TallPeopleNumber;int TallMoney0;int SingelMoney;//循环体for(TallPeopleNumber1;TallPeopleNumber<1000;TallPeopleNumber){printf("请输入单笔捐款金额:\n")…...

编程日记 2025/6/1 9:33:35

关于IDEA的循环依赖问题

bug描述：（java: 模块循环不支持注解处理。请确保将循环 [...] 中的所有模块排除在注解处理之外） 解决方法：...

编程日记 2025/5/29 13:34:40

uniapp跳转和获取参数方式

1.小程序跳转 1.1 原生组件跳转 <navigator url"/pages/about/about?id10">跳转</navigator> 1.2 方法接口跳转 uni.navigateTo({url:/pages/about/about?id2}) 2.获取参数值页面获取id值 onLoad(e) {console.log(e.id);}...

编程日记 2025/5/29 11:06:43

BP 算法探秘：神经网络的幕后引擎

大家好，我是沛哥儿，很高兴又和大家见面了。在人工智能的世界里，神经网络如同大脑一般神秘又强大，而其中 **BP 算法（Backpropagation Algorithm）**就是驱动这个 “大脑” 不断学习进化的幕后引擎。文章目录…...

编程日记 2025/5/27 22:38:15

物联网相关

文章目录 1 MQTT2 MQTT FX3 EMQ X 1 MQTT MQTT是一种基于发布/订阅模式的轻量级物联网消息协议，全称为Message Queuing Telemetry Transport（消息队列遥测传输）。它具有低功耗、低带宽占用、可靠性高等特点，广泛应用于物联网设备…...

编程日记 2025/5/15 5:47:02

【Axure高保真原型】3级多选下拉列表

今天和大家分享3级多选下拉列表原型模板，这个模版是用中继器制作的，所以使用也很方便，选项的数据在中继器表格里维护即可自动生成交互效果，具体效果可以打开下方原型地址体验或者点击下方视频观看【原型效果含使用说明】【Axur…...

编程日记 2025/5/29 8:45:30

光敏材料与智能传感技术的能源系统创新研究

一、光敏储能体系的作用机理与技术创新 1.1 分子光能转换机制基于分子构型变化的能量存储技术展现出独特优势，其核心机理涉及光敏材料在光照下的可逆分子构型变化。以偶氮苯体系为例，在365nm紫外光激发下，分子发生反式到顺式的异构转变&…...

编程日记 2025/5/19 12:04:12

Docker 安装 kafka （bitnami/kafka:4.0）

1、拉取镜像 docker pull bitnami/kafka:4.02、创建挂载目录 mkdir -p /user/lzl/tool/docker/kafka/bitnami/bitnami_kafka_4.0/home/datamkdir -p /user/lzl/tool/docker/kafka/bitnami/bitnami_kafka_4.0/home/logs3、给挂载目录授权 chmod 777 /user/lzl/tool/docker/ka…...

编程日记 2025/5/31 7:37:57

NameSilo转入转出域名

一、总起域名转入转出主要沟通方式就是靠注册邮箱收取转移授权码。因为namesilo的界面一直在慢慢改动（很慢很慢），所以本文和网上教程里的截图有所不同，以后本文可能也会与实际界面有所不同。二、转入域名 1. 在其它域名服务商…...

编程日记 2025/5/31 9:31:33

Python----深度学习（基于DNN的吃鸡预测）

一、目标如何使用 PyTorch 实现一个简单的深度神经网络（DNN）模型，并用于回归任务。该模型通过训练数据集来预测玩家在游戏中的最终排名百分比。代码通过读取数据集、数据处理、模型训练和模型评估等步骤。二、数据集介绍和平精英&#xf…...

编程日记 2025/5/22 22:53:34

DeepSeek系列（10）：与其他AI工具协同

DeepSeek与绘图AI配合使用在当今多元化的AI生态中，将不同专长的AI工具协同使用，能够实现远超单一工具的综合效果。DeepSeek作为强大的语言模型，与专业绘图AI的配合尤为默契，可以在创意构思与视觉呈现之间建立无缝桥梁。创意-视觉协作流程从文本到图像的完整路径创意…...

编程日记 2025/5/24 3:04:42

Spark-Streaming核心编程：有状态转化操作与DStream输出

在Spark-Streaming的学习旅程中，有状态转化操作和DStream输出是两个关键知识点，今天就来深入聊聊它们。先说说有状态转化操作，这里面 UpdateStateByKey 和 WindowOperations 很重要。 UpdateStateByKey 主要用于跨批次维护状态，就…...

编程日记 2025/5/27 6:58:40

Ldap高效数据同步- MirrorMode双主复制模式配置详解（上）

#作者：朱雷文章目录一、Syncrepl 复制和MirrorMode复制1.1. 什么是复制模式1.2. 什么是 syncrepl同步复制1.3. 什么是 MirrorMode 复制（双主模式）1.4. 双数据中心配置镜像模式架构二、Ldap环境部署三、配置Mirror复制类型3.1. 配置节点1配…...

编程日记 2025/5/29 17:12:32

【刷题Day28】Python/JAVA - 02（浅）

Python 什么是 Python 的闭包？ 闭包（Closure）是Python中的一种独特的函数机制。简而言之，闭包是指在一个内部函数中，引用了外部函数的变量，而这个外部函数已经执行完毕并返回了内部函数，然而内…...

编程日记 2025/5/29 12:44:28

纯净IP的优势：稳定性与安全性的结合

在跨境电商、数据采集、社交运营等对网络质量要求高的场景中，选择一个可靠的IP资源，是保护账号安全、提升业务效率的关键。纯净IP凭借其独特的稳定性与安全性，成为越来越多用户的选择。本文将带你深入了解纯净IP的价值，以及如何应…...

编程日记 2025/5/27 7:59:35

探索DeepWiki：GitHub源码阅读的变革性工具

DeepWiki 是什么 DeepWiki 是由 Cognition Labs 精心打造的一款创新工具，堪称 GitHub Repo 源代码的 “智慧解读器”，能将其转化为可对话式文档 ，为开发者提供实时交流、即时更新文档的功能。它基于 Devin 技术，为每一个 GitHub …...

编程日记 2025/6/4 6:00:43

基于WebRTC技术，EasyRTC音视频实时通话助力全网会议的智能化转型

一、方案背景随着数字化转型，企业、教育、政府等对全网会议需求激增。传统视频会议部署复杂、成本高、兼容性差，无法满足远程协作的多样化需求。EasyRTC实时通信功能强大，能为全网会议提供高效、稳定、易用的解决方案，支持多终端…...

编程日记 2025/5/20 10:10:21

设计模式全解析：23种经典设计模式及其应用

创建型模式 1. 单例模式（Singleton Pattern） 核心思想：确保一个类只有一个实例，并提供一个全局访问点。适用场景：需要共享资源的场景，如配置管理、日志记录等。 public class Singleton {// 静态变量保存…...

编程日记 2025/5/24 4:16:53

Web开发-JavaEE应用依赖项Log4j日志Shiro验证FastJson数据XStream格式

知识点： 1、安全开发-JavaEE-第三方依赖开发安全 2、安全开发-JavaEE-数据转换&FastJson&XStream 3、安全开发-JavaEE-Shiro身份验证&Log4j日志处理一、演示案例-WEB开发-JavaEE-第三方依赖&FastJson&XStream FastJson 一个阿里巴巴开发的J…...

编程日记 2025/5/29 9:48:34

小集合 VS 大集合：MySQL 去重计数性能优化

小集合 VS 大集合：MySQL 去重计数性能优化前言一、场景与问题 🔎二、通俗执行流程对比三、MySQL 执行计划解析 📊四、性能瓶颈深度剖析 🔍五、终极优化方案 🏆六、总结前言 📈 测试结果： 在…...

编程日记 2025/5/25 9:38:36

什么是模块化区块链？Polkadot 架构解析

原文：https://polkadot.com/blog/understanding-modular-blockchains/ 作者：Joey Prebys 编译：OneBlock 区块链的构建方式有很多种，而不同的架构选择会直接影响性能、可扩展性和开发者体验。随着行业的发展，单体区块…...

编程日记 2025/5/24 19:50:58

C++翻转数相乘 2024年信息素养大赛复赛 C++小学/初中组算法创意实践挑战赛真题详细解析

目录 C++翻转数相乘一、题目要求 1、编程实现 2、输入输出二、算法分析三、程序编写四、运行结果五、考点分析六、推荐资料 1、C++资料 2、Scratch资料 3、Python资料 C++翻转数相乘 2024年信息素养大赛 C++复赛真题一、题目要求 1、编程实现假设一个…...

编程日记 2025/5/27 21:51:59

Go 语言中的 `select` 语句详解

select 是 Go 语言中处理通道(Channel)操作的一个强大控制结构，它允许 goroutine 同时等待多个通道操作。下面我将全面详细地解释 select 语句的各个方面。基本语法 select 语句的基本语法如下： select { case <-ch1:// 如果从 ch1 成功接收数据&…...

编程日记 2025/5/22 3:06:09

Nacos简介—4.Nacos架构和原理二

大纲 1.Nacos的定位和优势 2.Nacos的整体架构 3.Nacos的配置模型 4.Nacos内核设计之一致性协议 5.Nacos内核设计之自研Distro协议 6.Nacos内核设计之通信通道 7.Nacos内核设计之寻址机制 8.服务注册发现模块的注册中心的设计原理 9.服务注册发现模块的注册中心的服务数…...

编程日记 2025/6/4 5:25:17

Web服务器技术选型指南：主流方案、核心对比与策略选择

Web服务器技术选型指南：主流方案、核心对比与策略选择一、主流Web服务器概览在当今互联网架构中，Web服务器承担着处理HTTP请求、管理资源分配和保障服务稳定性的核心职责。根据应用场景和技术特性的不同，主流的Web服务器可分为以下五类&a…...

编程日记 2025/6/2 14:05:14

Git和Gitlab的部署和操作

一。GIT的基本操作 1.GIT的操作和查看内容 [rootmaster ~]# yum install git -y [rootmaster ~]# git config --list：查看所有配置 2.GIT仓库初始化 [rootmaster ~]# mkdir /gittest：创建目录 [rootmaster ~]# cd /gittest/：进入目录 [rootm…...

编程日记 2025/6/1 9:19:00

【Git】初始Git及入门命令行

目录为什么学习 Git 这么重要？ 1. 安装 Git 2. 配置 Git 3. 创建本地 Git 仓库 1. git初始化远程仓库： git init 2. 就是要新增两个必须要配置的选项： name 和 email 3. 查看当前本地仓库的配置情况： git config -l 4. 删…...

编程日记 2025/5/19 8:20:41

自然语言to SQL的评估

一、怎么进行一个自然语言to SQL评估？ 1.DB——准备可用的数据表 2.准备问题集，自然语言|正确的预期SQL 3.大模型执行完成的SQL 4.Table.json——一个存储表格数据或者数据库表结构信息的 JSON 文件。当前是存储的表结构信息的，存储数据库…...

编程日记 2025/5/18 0:31:26

详解React Fiber架构中，reconcile阶段的具体工作流程

在 React Fiber 架构里，协调（Reconcile）阶段处于虚拟 DOM（VDOM）与实际 DOM 渲染之间，主要承担着把 VDOM 转化为 Fiber 节点树、开展 Diff 比较并标记节点变化的任务。下面详细阐述协调阶段的具体工作流程&a…...

编程日记 2025/5/26 6:51:44

迅雷精简绿色融合版【高速下载版】12.1.9.2870【11.2.2.1716】【20250426】

迅雷Thunder 11官方版会提示敏感需升级不能使用，本人制作的迅雷 12.1.9.2870【11.2.2.1716】精简绿色融合版是在11.2.2.1716版本的基础上制作的，实际版本号显示为12.1.9.2870，不是真正意义的迅雷12.1.9.2870精简绿色版，本实质上还…...

编程日记 2025/5/23 13:41:14

决策树相关案例

全流程以下是一个更复杂、全流程的决策树和随机森林示例，不仅包括模型训练和预测，还涵盖了数据预处理、超参数调优以及模型评估的可视化。我们依旧使用鸢尾花数据集，并额外引入 GridSearchCV 进行超参数调优，使用 matplotlib 进…...

编程日记 2025/5/22 3:33:11

AI音频核爆！Kimi开源“六边形战士”Kimi-Audio，ChatGPT语音版？

音频处理领域的天花板被撕开了。刚刚，kimi 发布全新通用音频基础模型 Kimi-Audio，这款由月之暗面（Moonshot AI）推出的开源模型，在 24 小时内收获 3.2 万星标，不仅以 1.28% 词错率刷新语音识别纪录&#xf…...

编程日记 2025/5/20 15:38:04

vscode vue 的插件点击组件不能跳转到文件问题解决

ctrl shift p 打开命令行，搜索更改语言模式选择第二项选择 vue 现在可以了...

编程日记 2025/5/15 17:15:01

二叉树的前序、中序和后序遍历：详解与实现

1. 前序遍历（Pre-order Traversal） 1.1 定义前序遍历的顺序是：先访问根节点，然后递归地遍历左子树，最后递归地遍历右子树。 1.2 访问顺序对于任意节点： 访问根节点。递归遍历左子树。递归遍历右子…...

编程日记 2025/5/24 19:24:49

5、Rag基础：RAG 专题

RAG 简介什么是检索增强生成？检索增强生成（RAG）是指对大型语言模型输出进行优化，使其能够在生成响应之前引用训练数据来源之外的权威知识库。大型语言模型（LLM）用海量数据进行训练，使用数十亿个参数为回答问题、翻译语言和完成句子等任务生成原始输出。在 LLM 本就强…...

编程日记 2025/5/24 5:03:34

FISCO BCOS 智能合约开发详解

一、FISCO BCOS 智能合约开发概览 FISCO BCOS 是一个国产开源联盟链平台，支持两种类型的智能合约：FISCO BCOS Documentation Solidity 合约：与以太坊兼容，使用 Solidity 语言编写，适用于灵活的业务逻辑开发。预…...

编程日记 2025/5/29 13:36:30

Linux操作系统从入门到实战（四）Linux基础指令（下）

Linux操作系统从入门到实战（四）Linux基础指令（下） 前言一、date 指令二、cal 指令三、find 指令四、which 指令五、whereis 指令六、alias 指令七、grep 指令八、zip/unzip 指令九、tar 指令（重要）十、bc 指…...

编程日记 2025/6/3 0:12:19

使用 LLM助手进行 Python 数据可视化

在数据科学中，数据可视化是一项至关重要的任务，旨在揭示数据背后的模式和洞察，并向观众传达这些信息。然而，在编程语言（如 Python）中创建有洞察力的图表有时可能会耗时且复杂。本文介绍了一种借助 AI 助手&…...

编程日记 2025/5/28 7:42:03

docker安装jenkins自动化测试

#搭建gitlab docker pull gitlab/gitlab-ce docker run -d\--hostname localhost \-p 443:443 -p 80:80 -p 2222:22 \--name gitlab \-v /myproject/gitlab/config:/etc/gitlab \-v /myproject/gitlab/logs:/var/log/gitlab \-v /myproject/gitlab/data:/var/opt/gitlab \gitla…...

编程日记 2025/5/27 6:39:20

所以你看到“即使把那两行全局注册删掉，也能正常上传／查询”，并不奇怪：

核心原理回顾

为什么你“以前删掉会报错”？

现在为啥又“删了也能正常”？

建议

小结

何时用哪种方式？

相关文章：