MySQL 中查询 VARCHAR 类型 JSON 数据的问题记录

更新时间：2025年04月14日 10:08:32 作者：yzhSWJ

在数据库设计中,有时我们会将 JSON 数据存储在 VARCHAR 或 TEXT 类型字段中,本文将详细介绍如何在 MySQL 中有效查询存储为 VARCHAR 类型的 JSON 数据,感兴趣的朋友一起看看吧

一、问题背景

当 JSON 数据存储在 VARCHAR 列中时，常见的数据格式如下：

[
  {"id":"1905555466980773889","hasPermission":true},
  {"id":"1905547884060835841","hasPermission":false}
]

我们需要查询这个 JSON 数组中是否包含特定 ID 的对象。

二、MySQL JSON 函数

MySQL 5.7+ 版本提供了丰富的 JSON 处理函数，即使数据类型是 VARCHAR，只要内容是有效的 JSON，我们仍然可以使用这些函数：

2.1 常用 JSON 函数

JSON_CONTAINS(target, candidate[, path]): 检查 JSON 文档是否包含特定值
JSON_EXTRACT(json_doc, path): 从 JSON 文档中提取值
JSON_OBJECT(key, val[, key, val]...): 创建 JSON 对象
JSON_ARRAY(val[, val]...): 创建 JSON 数组
JSON_VALID(json_doc): 验证字符串是否为有效的 JSON

三、查询示例

3.1 基本查询

查询 JSON 数组中包含特定 ID 的记录：

SELECT * FROM sys_user
WHERE 
  app_ids IS NOT NULL
  AND app_ids != ''
  AND JSON_CONTAINS(app_ids, JSON_OBJECT('id', '1905555466980773889'));

3.2 查询多个 ID

SELECT * FROM sys_user
WHERE 
  app_ids IS NOT NULL
  AND app_ids != ''
  AND (
    JSON_CONTAINS(app_ids, JSON_OBJECT('id', '1905555466980773889'))
    OR JSON_CONTAINS(app_ids, JSON_OBJECT('id', '1905547884060835841'))
  );

3.3 使用 JSON_OVERLAPS (MySQL 8.0+)

SELECT * FROM sys_user
WHERE 
  app_ids IS NOT NULL
  AND app_ids != ''
  AND JSON_OVERLAPS(
    app_ids, 
    JSON_ARRAY(
      JSON_OBJECT('id', '1905555466980773889'),
      JSON_OBJECT('id', '1905547884060835841')
    )
  );

3.4 查询特定权限的记录

SELECT * FROM sys_user
WHERE 
  app_ids IS NOT NULL
  AND app_ids != ''
  AND JSON_CONTAINS(
    app_ids, 
    JSON_OBJECT('id', '1905555466980773889', 'hasPermission', true)
  );

四、避免常见错误

4.1 空值处理

JSON_CONTAINS 函数在处理 NULL 或空字符串时会报错，所以需要先排除这些情况：

-- 错误做法
SELECT * FROM sys_user WHERE JSON_CONTAINS(app_ids, JSON_OBJECT('id', '123'));
-- 正确做法
SELECT * FROM sys_user 
WHERE 
  app_ids IS NOT NULL 
  AND app_ids != '' 
  AND JSON_CONTAINS(app_ids, JSON_OBJECT('id', '123'));

4.2 JSON 格式匹配

确保 JSON_CONTAINS 的第二个参数结构与目标 JSON 中的结构匹配：

-- 错误做法 (直接传入 ID 字符串)
SELECT * FROM sys_user WHERE JSON_CONTAINS(app_ids, '"1905555466980773889"');
-- 正确做法 (创建与数组元素匹配的对象)
SELECT * FROM sys_user WHERE JSON_CONTAINS(app_ids, JSON_OBJECT('id', '1905555466980773889'));

4.3 确保 JSON 有效性

添加 JSON_VALID 检查确保字段内容是有效的 JSON：

SELECT * FROM sys_user
WHERE 
  app_ids IS NOT NULL
  AND app_ids != ''
  AND JSON_VALID(app_ids) = 1
  AND JSON_CONTAINS(app_ids, JSON_OBJECT('id', '1905555466980773889'));

五、在 MyBatis Plus 中的应用

5.1 基本查询

LambdaQueryWrapper<SysUser> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.isNotNull(SysUser::getAppIds)
            .ne(SysUser::getAppIds, "")
            .apply("JSON_CONTAINS(app_ids, JSON_OBJECT('id', {0}))", "1905555466980773889");
List<SysUser> userList = sysUserMapper.selectList(queryWrapper);

5.2 多条件查询

QueryWrapper<SysUser> queryWrapper = new QueryWrapper<>();
queryWrapper.isNotNull("app_ids")
            .ne("app_ids", "")
            .apply("JSON_VALID(app_ids) = 1")
            .apply("JSON_CONTAINS(app_ids, JSON_OBJECT('id', {0}))", "1905555466980773889");
// 如果还要根据权限过滤
queryWrapper.apply("JSON_CONTAINS(app_ids, JSON_OBJECT('id', {0}, 'hasPermission', {1}))", 
                   "1905555466980773889", true);

5.3 查询多个 ID

LambdaQueryWrapper<SysUser> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.isNotNull(SysUser::getAppIds)
            .ne(SysUser::getAppIds, "")
            .and(w -> w.apply("JSON_CONTAINS(app_ids, JSON_OBJECT('id', {0}))", "1905555466980773889")
                      .or()
                      .apply("JSON_CONTAINS(app_ids, JSON_OBJECT('id', {0}))", "1905547884060835841"));
List<SysUser> userList = sysUserMapper.selectList(queryWrapper);

六、性能优化建议

考虑使用 JSON 类型：如果您的 MySQL 版本是 5.7+，考虑使用原生 JSON 类型代替 VARCHAR，这样可以获得更好的性能和功能支持。

添加索引：虽然无法直接为 JSON 内容创建索引，但可以使用生成的列和函数索引：

ALTER TABLE sys_user ADD COLUMN app_id_extracted JSON 
  GENERATED ALWAYS AS (JSON_EXTRACT(app_ids, '$[*].id')) VIRTUAL;
ALTER TABLE sys_user ADD INDEX idx_app_id_extracted (app_id_extracted);

定期维护：对于大表，定期 OPTIMIZE TABLE 有助于维护性能。

七、总结

在 MySQL 中查询 VARCHAR 类型的 JSON 数据时，关键是：

使用 JSON_CONTAINS 函数并构造正确的 JSON 结构进行匹配
处理好 NULL 和空字符串
验证 JSON 有效性
在 MyBatis Plus 中使用 apply 方法添加原生 SQL 条件

正确使用这些技术可以有效地查询和处理 VARCHAR 中存储的 JSON 数据。

到此这篇关于MySQL 中查询 VARCHAR 类型 JSON 数据的的文章就介绍到这了,更多相关mysql 查询 VARCHAR 类型 JSON 数据内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

mysql distinct去重,IFNULL空值处理方式
文章介绍了如何在MySQL中使用`DISTINCT`命令去重和使用`IFNULL`函数处理空值,首先,通过Navicat新建数据库并准备数据,然后展示了如何使用`DISTINCT`命令去除重复数据和使用`IFNULL`函数将空值替换为“暂无”
2025-01-01
5招带你轻松优化MySQL count(*)查询性能
最近在公司优化了几个慢查询接口的性能，总结了一些心得体会拿出来跟大家一起分享一下，文中的示例代码讲解详细，希望对大家会有所帮助
2022-11-11
SQL处理时间戳时如何解决时区问题实例详解
时间戳时间不分东西南北、在地球的每一个角落都是相同的,下面这篇文章主要给大家介绍了关于SQL处理时间戳时如何解决时区问题的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2022-08-08
mysql函数split功能实现
mysql 5.* 的版本现在没有split 函数，但有些地方会用，在这里就简单记录一下
2012-09-09
mysql基础架构教程之查询语句执行的流程详解
这篇文章主要给大家介绍了关于mysql基础架构教程之查询语句执行流程的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起看看吧
2018-11-11
一文了解MYSQL三大范式和表约束
范式是"符合某一种级别的关系模式的集合,表示一个关系内部各属性之间的联系的合理化程度",下面这篇文章主要给大家介绍了关于MYSQL三大范式和表约束的相关资料,需要的朋友可以参考下
2022-04-04
Mysql中的几种常见日志小结
本文主要介绍了Mysql中的几种常见日志小结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-08-08
CentOS系统中MySQL5.1升级至5.5.36
有相关测试数据说明从5.1到5.5+，MySQL性能会有明显的提升，具体的需要自己建立测试环境去实践下，今天我们就来操作下，并记录下来升级的具体步骤
2017-07-07
MySql索引原理和SQL优化方式
索引是提升数据库查询效率的有序存储结构,包括主键索引、唯一索引、普通索引等,约束则用于数据完整性,包含主键、唯一、外键等约束,B+树是常用的索引结构,减少磁盘IO次数,索引应用场景包括where、groupby、orderby
2024-09-09
详解MySQL中SlowLog的配置方法(图文)
mysql 日志系统上线有段时间了,前端在慢慢切站点过来写入,未雨绸缪 diy了套 mysql 监控工具
2014-02-02