不能直接当普通字段用。django 自带 jsonfield 在 mysql 下默认用 text+序列化，不支持原生 json 操作符；需 django ≥ 3.1 + mysql ≥ 5.7 并显式启用原生支持，正确声明字段并使用双下划线语法查询，更新需用 json_set 等函数避免覆盖。
MySQL 5.7+ 的 JSONField 在 Django 中能直接用吗？
不能直接当普通字段用。Django 自带的 JSONField 在 MySQL 下默认走的是 TEXT 类型 + 序列化存储，不调用 MySQL 原生 JSON 函数，也就没法用 ->、@> 这些操作符做高效查询。
想真正用上 MySQL 的 JSON 功能，得满足两个条件：Django ≥ 3.1 + MySQL ≥ 5.7，且显式启用原生支持。
- 确认数据库配置里
OPTIONS包含'init_command': "SET json = 1"（非必需，但某些旧驱动需要） - 模型字段声明必须用
models.JSONField(encoder=..., decoder=...)，否则 Django 仍走字符串 fallback - Django 4.2+ 默认启用原生支持，但老版本需手动设置
db_parameters={'type': 'json'}（实际无效，别试）
如何正确声明一个可查询的 JSONField？
关键不是字段类型，而是字段定义方式和后续查询写法。Django 会根据后端自动选择实现路径，但你得“提示”它走原生路线。
推荐写法：
from django.db import models <p>class Product(models.Model): data = models.JSONField(default=dict)</p><h1>不要加 db_column='data_json' 或自定义 db_type</h1><pre class="brush:php;toolbar:false;"><code># 不要覆盖 get_db_prep_value</code>
如果已有旧字段是 TextField 存 JSON 字符串，别直接改字段类型——迁移会失败。应新建字段 + 数据迁移脚本 + 逐步切换。
怎么用 filter() 查 JSON 内的嵌套值？
MySQL 原生 JSON 查询靠 JSON_EXTRACT() 和操作符，Django 抽象层把它映射成双下划线链式语法，但有严格限制。
-
data__name__icontains='abc'→ 可用，生成JSON_CONTAINS(data, '"abc"', '$.name') -
data__tags__0__id=123→ 可用，对应data->'$.tags[0].id' -
data__price__gt=99→ 失败！MySQL JSON 字段不能直接比较大小，必须先用CAST(JSON_EXTRACT(...), DECIMAL) - 数组长度判断要用
data__tags__len__gt=2，底层转成JSON_LENGTH(data->'$.tags')
复杂条件建议用 extra() 或原生 SQL：filter(extra(where=["JSON_CONTAINS(data, %s, '$.features')"], params=['"search"']))
更新 JSON 字段时容易覆盖整个对象
直接赋值 obj.data = {'a': 1} 再 save() 会丢掉原有字段。MySQL 原生 JSON 更新必须用 JSON_SET()、JSON_REPLACE() 等函数，Django 不自动帮你拼。
- 安全做法：读出当前值 → 修改 Python dict → 全量写回（适合并发低、数据小）
- 高性能做法：用
update()+Func表达式：Product.objects.filter(id=1).update(data=Func(F('data'), Value('$.status'), Value('active'), function='JSON_SET')) - 注意
JSON_INSERT()和JSON_SET()行为不同：前者只在路径不存在时插入，后者强制覆盖
没做事务包裹的 JSON 更新，在高并发下可能丢失中间修改——因为 MySQL JSON 函数是原子的，但 Python 层读-改-写不是。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
