GeneratedField 是 Django 5.0 引入的只读数据库计算列字段，用于在数据库层面实时生成值（如 full_name 拼接、LOWER(email)），解决手动维护、重复计算和数据一致性问题。
GeneratedField 是什么，它能解决什么问题
GeneratedField 是 Django 5.0 引入的新字段类型，用于在数据库层面定义计算列（computed column），而不是在 Python 层做逻辑拼接或冗余存储。它不接受用户写入，只读，值由数据库实时生成（如 PostgreSQL 的 GENERATED ALWAYS AS 或 MySQL 的 STORED/VIRTUAL）。
它的典型用途是：避免在 save() 中手动维护字段、规避 ORM 层重复计算、保证数据一致性（比如 full_name 拼接 first_name 和 last_name）、或依赖数据库函数（如 LOWER(email)、CONCAT、时间戳截断等）。
注意：它不是 Python 表达式字段，不能引用其他模型实例或调用方法；必须是数据库可执行的 SQL 表达式。
怎么定义一个 GeneratedField
定义时需指定 expression（SQL 字符串或 models.Expression 子类）、output_field（明确返回类型）、以及可选的 db_persist（是否物理存储，默认 True）。
立即学习“Python免费学习笔记（深入）”；
from django.db import models
<p>class User(models.Model):
first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50)
email = models.EmailField()</p><pre class='brush:python;toolbar:false;'>full_name = models.GeneratedField(
expression=models.F('first_name') + models.Value(' ') + models.F('last_name'),
output_field=models.CharField(max_length=101),
db_persist=True,
)关键点：
-
expression必须是models.Expression实例（推荐），不能是原始字符串（如"first_name || ' ' || last_name"会报错） -
output_field必须显式声明，Django 不会自动推导；类型要和数据库实际返回一致（比如用models.CharField对应TEXT或VARCHAR） -
db_persist=True表示该列物理存储（PostgreSQL 支持STORED，MySQL 默认STORED）；设为False则仅虚拟计算（MySQLVIRTUAL，PostgreSQL 不支持）
迁移生成与数据库兼容性限制
运行 python manage.py makemigrations 后，Django 会生成包含 ADD COLUMN ... GENERATED ALWAYS AS ... STORED 的迁移文件（PostgreSQL）或类似语法（MySQL 8.0.22+）。但要注意：
- PostgreSQL 12+ 才支持
GENERATED ALWAYS AS（且仅支持STORED） - MySQL 要求版本 ≥ 8.0.22，且引擎必须是
InnoDB - SQLite 不支持生成列，
GeneratedField在 SQLite 下会被忽略（迁移仍通过，但字段不存在，查询会报FieldDoesNotExist） - Oracle、SQL Server 等后端暂不支持，使用会直接报错（Django 5.0 当前未实现适配）
如果项目需多数据库支持，不要把 GeneratedField 作为核心业务字段，或用条件迁移（if connection.vendor == 'postgresql'）隔离。
查询和使用时的注意事项
GeneratedField 可以像普通字段一样用于 filter()、order_by()、values()，但有几处容易踩坑：
- 它不能出现在
create()或update()的字段列表中（Django 会抛出FieldError: Cannot update generated field） - 在
bulk_create()中传入该字段值会被静默忽略（不会报错，但也不生效） - 使用
values_list('full_name', flat=True)是安全的；但若表达式含数据库函数（如Lower('email')），某些旧版 MySQL 可能无法在GROUP BY中直接引用别名 - 如果表达式依赖的源字段为空（
NULL），整个生成结果通常为NULL（取决于数据库行为），例如first_name + ' ' + last_name中任一为NULL，结果就是NULL—— 这比 Python 层拼接更严格，得提前用Coalesce处理
GeneratedField 的真正价值在于把确定性计算下推到数据库，但这也意味着调试更难：你得查数据库日志、确认表达式语法、验证不同 DBMS 的行为差异。别指望它像 @property 那样灵活。
