MySQL JSON_STORAGE_SIZE 为什么不等于 JSON 文本长度

排查 JSON 字段容量时，很多人会先对原始字符串执行 LENGTH()，再拿结果和 JSON_STORAGE_SIZE() 对比，发现两个数字不一样就以为 MySQL 统计错了。其实它们测的对象不同：前者测字符串的字节数，后者测解析后 JSON 二进制表示占用的字节数。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/json-utility-functions.html

判断原则很简单：需要知道传入文本有多大，用 CHAR_LENGTH() 或 LENGTH()；需要知道 JSON 值按 MySQL 二进制格式占用多少空间，用 JSON_STORAGE_SIZE()。如果 JSON 列做过部分更新，再配合 JSON_STORAGE_FREE() 看释放但尚未重新整理的空间。

JSON_STORAGE_SIZE 统计的不是原始文本

JSON_STORAGE_SIZE(json_val) 会先把字符串解析为 JSON，再计算其二进制表示。JSON 文本里的缩进、换行和多余空格主要属于输入格式；解析后，MySQL 按对象、数组、数字、字符串等类型组织数据，还要保存键名、长度和结构信息，所以结果不会等于文本字符数。

先把三个尺寸放在同一条查询里

排查时不要只看一个函数，保留原文、字符数、字节数和 JSON 存储大小四列，才能知道差异从哪一层开始。

SELECT
  JSON_OBJECT('name', '林', 'tags', JSON_ARRAY('go', 'mysql')) AS doc,
  CHAR_LENGTH(JSON_OBJECT('name', '林', 'tags', JSON_ARRAY('go', 'mysql'))) AS char_count,
  LENGTH(JSON_OBJECT('name', '林', 'tags', JSON_ARRAY('go', 'mysql'))) AS text_bytes,
  JSON_STORAGE_SIZE(JSON_OBJECT('name', '林', 'tags', JSON_ARRAY('go', 'mysql'))) AS binary_bytes;
-- char_count 统计字符，LENGTH 统计 UTF-8 字节，JSON_STORAGE_SIZE 统计二进制 JSON 字节。
-- 同一表达式重复计算只用于定位差异，生产查询可先放入列或 CTE 以便复用。

中文会让字符数和字节数出现差异，但这仍然只是文本编码层面的差异。二进制 JSON 还受到值类型和结构的影响，不能用“文本少几个字符”直接推算它会少几个字节。

部分更新会让 JSON_STORAGE_SIZE 保持不变

真正容易误判的是 JSON 列的就地部分更新。使用 JSON_SET()、JSON_REPLACE() 或 JSON_REMOVE() 修改列时，如果新值更短，MySQL 可能留下可复用空间。此时 JSON_STORAGE_SIZE() 仍反映该 JSON 文档插入时占用的大小，而 JSON_STORAGE_FREE() 告诉你其中有多少空间被释放。

CREATE TABLE json_probe (payload JSON);
-- 用 JSON 列保存文档，后续才能观察部分更新产生的空闲空间。
INSERT INTO json_probe VALUES ('{"id":1000,"note":"long-value","active":true}');

SELECT JSON_STORAGE_SIZE(payload) AS stored_bytes,
       JSON_STORAGE_FREE(payload) AS free_bytes
FROM json_probe;
-- 初次插入通常 free_bytes 为 0；这里的 stored_bytes 不是原文 LENGTH。

UPDATE json_probe
SET payload = JSON_SET(payload, '$.note', 'x');
-- 通过 JSON_SET 更新列，可能复用原文档空间并留下可复用空闲区。

SELECT JSON_STORAGE_SIZE(payload) AS stored_bytes,
       JSON_STORAGE_FREE(payload) AS free_bytes
FROM json_probe;
-- stored_bytes 可能不变，free_bytes 用来解释这次差异。

如果直接给 JSON 列重新赋一个字符串，属于完整替换，函数会按新值重新计算；不要把这种结果和部分更新混在一起比较。

按参数类型排查结果差异

另外，非法 JSON 会报错；函数并不会把普通文本当作 JSON 原样计数。容量监控因此要记录参数来源和更新方式，不能只保存一个数值。

相关问题

JSON_STORAGE_SIZE 能替代 LENGTH 吗？不能。LENGTH 适合估计传输或文本字段字节数，JSON_STORAGE_SIZE 适合观察 MySQL 二进制 JSON 表示。

为什么 JSON_STORAGE_FREE 不是每次都大于 0？只有列更新能够利用部分更新且新表示确实释放空间时才会出现正值；完整替换或空间没有减少时可能返回 0。

怎样估算 JSON 列容量？对真实 JSON 列分布抽样查询 JSON_STORAGE_SIZE，并把 JSON_STORAGE_FREE、更新方式和索引开销分开记录。

总结

“文本长度”和“JSON 存储大小”是三个不同层次的问题：字符数看 CHAR_LENGTH()，文本字节看 LENGTH()，二进制 JSON 看 JSON_STORAGE_SIZE()。遇到部分更新后的不等值，再补查 JSON_STORAGE_FREE()，通常就能解释差异来自解析布局还是列空间复用。