GeneratedField是Django 5.0中映射数据库原生生成列的字段，需显式指定expression和db_persist=True，值由数据库在INSERT/UPDATE时计算并持久化，不可写、不参与Python层逻辑。
GeneratedField 在 Django 5.0 中只能用于数据库层计算，不能替代 Python 层逻辑
GeneratedField 不是“自动计算的 model 字段”，它本质是数据库的 GENERATED ALWAYS AS（PostgreSQL/MySQL 8.0.30+）或 AS（SQLite）表达式列，值完全由数据库在 INSERT/UPDATE 时生成并存储（或虚拟计算），Django 不会在 Python 层执行该逻辑。这意味着：
-
GeneratedField的表达式必须能被目标数据库原生支持，Django 不做翻译或降级处理 - 字段不可写（
editable=False强制生效），也不能出现在form.save()或Model.objects.create()的字段列表中 - 查询时它像普通字段一样可用，但修改依赖数据库触发器或重新 INSERT —— Django ORM 不提供“刷新”接口
- 若用 SQLite 开发、PostgreSQL 生产，需确认表达式语法兼容（例如 PostgreSQL 支持
COALESCE(a, b)，SQLite 同样支持；但窗口函数、JSON 操作等可能不一致）
定义 GeneratedField 必须显式指定 db_persist 和 expression
少写一个参数就会报错：TypeError: GeneratedField.__init__() missing 2 required positional arguments: 'expression' and 'db_persist'。正确写法要同时满足：
-
expression是一个DatabaseFunction或字符串（推荐前者，类型安全） -
db_persist=True表示存为物理列（默认行为，也是唯一支持的选项；False在 Django 5.0 中尚未实现，会抛NotImplementedError） - 必须设置
db_column（显式命名底层字段，避免迁移时生成随机名）
例如，给用户模型加一个全名拼接字段：
from django.db import models
from django.db.models import Value, CharField
from django.db.models.functions import Concat
class User(models.Model):
first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50)
full_name = models.GeneratedField(
expression=Concat('first_name', Value(' '), 'last_name'),
output_field=CharField(max_length=101),
db_persist=True,
db_column='full_name',
)
注意：output_field 类型必须与数据库实际返回类型匹配，否则查询可能出错（如用 IntegerField 接收字符串表达式会触发类型转换异常）。
迁移会失败？检查数据库版本和表达式合法性
Django 5.0 对 GeneratedField 的迁移支持较新，常见失败原因不是代码问题，而是环境卡点：
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期，并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看，该技能
- PostgreSQL 用户需 ≥ 12（支持
GENERATED ALWAYS AS），低于此版本会报错：ProgrammingError: syntax error at or near "ALWAYS" - MySQL 用户需 ≥ 8.0.30（早期 8.0 版本不支持
STORED列的某些函数），否则迁移时提示：OperationalError: Invalid default value for 'xxx' - SQLite 用户需 ≥ 3.31.0（支持
AS虚拟列），旧版会静默忽略该字段，导致查询返回None - 表达式含聚合（
Count、Sum）、子查询或跨表字段（如'order__total'）—— 数据库不支持，迁移直接中断
验证方式：先在数据库 CLI 中手动执行等效 SQL，例如 PostgreSQL：
ALTER TABLE myapp_user ADD COLUMN full_name TEXT GENERATED ALWAYS AS (first_name || ' ' || last_name) STORED;
QuerySet 中使用 GeneratedField 时，别误以为它能触发实时更新
GeneratedField 值只在 INSERT/UPDATE 行时由数据库计算一次。如果你修改了 first_name 但没保存模型，full_name 不会变；即使调用了 save()，也仅当该字段本身未显式赋值时才触发重算（数据库行为，非 Django 控制）。
- 批量更新（
Model.objects.filter(...).update(first_name='X')）不会触发full_name重算 —— 因为绕过了模型层，数据库也不会自动刷新生成列 - 想强制刷新？只能用原始 SQL：
cursor.execute("UPDATE myapp_user SET first_name = first_name WHERE id = %s", [obj.id])（触发重计算），或分两步：先 update 基础字段，再单独 UPDATE 生成列（不推荐） - 在
.values()或.annotate()中引用full_name没问题，但它仍是数据库计算结果，不是 Python 表达式缓存
最易被忽略的一点：测试环境用 SQLite、生产用 PostgreSQL 时，GeneratedField 在 SQLite 中是虚拟列（不占存储，每次查都算），而 PostgreSQL 是物理存储列（INSERT 时即计算并写入）。这意味着数据一致性逻辑不能依赖“生成列是否为空”来判断业务状态。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
