java用jdbc操作mysql json列的核心是字符串收发、手动校验与函数配合；建表须用json类型，读取用getstring()后解析，写入需序列化合法字符串并设null，查询应使用->>/->等mysql函数配合参数化。

Java 中用 JDBC 直接操作 MySQL 的 JSON 列，核心是“字符串收发 + 手动校验 + 函数配合”，不依赖 ORM 框架也能安全高效。关键不是把 JSON 当对象用，而是把它当作受控的文本字段来处理。

建表与字段类型必须明确为 JSON

MySQL 5.7+ 要真正发挥 JSON 优势，字段定义必须用 JSON 类型，不能用 VARCHAR 或 TEXT 代替：

• 建表语句示例：CREATE TABLE product (id INT PRIMARY KEY, specs JSON);
• 插入时 MySQL 自动校验格式，非法 JSON 会直接报错（如缺少引号、逗号错误），这是第一道安全防线
• 查询返回的仍是字符串，JDBC 读取后需自行解析；写入前必须确保是合法 JSON 字符串

读取：用 getString() 获取字符串，再用 Jackson/Fastjson 解析

JDBC ResultSet 对 JSON 列返回的是标准 JSON 字符串，直接调用 getString() 即可：

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

• 不要用 getObject() 或 getBytes()，易出错且无必要
• 解析时若需保留字段顺序（如多语言场景），Jackson 要显式启用有序映射：mapper.configure(DeserializationFeature.USE_ORDERED_MAP, true)
• 推荐用 LinkedHashMap<string object></string> 接收，避免 HashMap 导致顺序丢失
• Fastjson 可用：JSON.parseObject(jsonStr, LinkedHashMap.class, Feature.OrderedField)

写入：序列化后传字符串，严禁拼接

向 JSON 列写入数据，必须先构造 Java 对象或 Map，再统一序列化为合法 JSON 字符串：

• 正确做法：String jsonStr = objectMapper.writeValueAsString(map); 再 setString 给 PreparedStatement
• 禁止手动拼接字符串（如 "{'name':'"+name+"'}"），极易引入语法错误或 SQL 注入风险
• 插入前建议做一次校验：objectMapper.readTree(jsonStr)，捕获 JsonProcessingException 可提前发现格式问题
• 如果值为 null，PreparedStatement 中应设为 setNull(index, Types.OTHER)，MySQL 允许 JSON 列为 NULL

查询 JSON 内部字段：用 MySQL 函数 + 参数化

需要按 JSON 内某个 key 查询时，别在 Java 层全量拉取再过滤，应利用 MySQL 原生能力：

• 提取值用 ->>（去引号）或 ->（带引号），例如：SELECT id, specs->>'$.brand' AS brand FROM product
• 条件查询示例：WHERE specs->>'$.category' = ?，PreparedStatement 中传入字符串参数即可
• 多层级提取支持点号路径：specs->>'$.detail.warranty.months'
• 数组元素可用下标：specs->>'$[0].name'
• 注意：直接在 WHERE 中用 ->> 无法走索引，高频查询建议配合虚拟列 + B-tree 索引

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南