Ent 不是“赋值即生效”的 ORM，需显式调用 Create() 或 Update().Save() 才写入数据库；修改查询出的实体字段无效，且未导出类型或错误路径会导致 ent generate 失败；MySQL 时间偏移需统一用 UTC 并指定 TIMESTAMP 类型；GraphQL 易 N+1，应预加载或批量查询。
Ent 不是“赋值即生效”的 ORM，它不跟踪字段变更，也不自动 flush——所有写入必须显式调用 Create() 或 Update().Save()，否则改了字段也进不了数据库。
为什么改了 user.Name 却没存进库？
因为 Ent 是纯函数式设计：没有脏检查、没有隐式同步。你从 Query() 查出来的 *User 是只读快照，直接改 user.Name = "alice" 完全无效，甚至调 .Save(ctx) 会 panic 报 "object has no ID"。
实操建议：
- 插入新记录：用
client.User.Create().SetName("alice").Save(ctx) - 更新已有记录：必须用
user.Update().SetName("alice").Save(ctx)（注意是.Update()开头） - 别混用：已有实体不能调
Create()，新对象不能调Update()
ent generate 为啥不生成 client.go 和模型方法？
不是命令错了，而是 entc 根本没“看到”你的 schema。它只扫描 ent/schema/ 目录下属于 package schema 的 Go 文件，且要求所有被引用的类型（比如枚举值、自定义类型）必须导出（首字母大写）。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
ent generate后ent/client.go不存在，或ent/user/目录为空 - 报错
cannot load schema: undefined: statusValues（因为写了field.Enum("status").Values(statusValues)，而statusValues是小写变量）
实操建议：
- 确认所有 schema 文件路径为
ent/schema/user.go、ent/schema/post.go，且第一行是package schema - 枚举值定义成导出常量：
var StatusValues = []string{"active", "inactive"} - 运行前先
go mod tidy，避免 ent 版本不一致导致生成器静默跳过
time.Time 字段在 MySQL 里时间对不上？
根本原因是 field.Time 在不同数据库底层映射不一致：PostgreSQL/SQLite 默认按 UTC 存 TIMESTAMP，但 MySQL 的 DATETIME 默认按系统时区解析，导致查出来偏移几小时。
实操建议：
- 强制 MySQL 用带时区语义的类型：
field.Time("created_at").SchemaType(map[string]string{"mysql": "TIMESTAMP"}) - Go 层一律用
time.Now().In(time.UTC)构造时间，禁用裸time.Now() - Docker 运行 MySQL 时加
-e TZ=UTC，避免本地环境与 CI 时区不一致引发偶发失败
GraphQL resolver 里查关联数据变 N+1？
Ent 本身无懒加载，但 GraphQL 按字段拆解 resolver 的习惯极易触发 N+1：比如用户列表返回每个用户的 Posts，若 resolver 写成 user.QueryPosts().All(ctx) 循环调用，就会对每个用户发一次 SQL。
实操建议：
- 批量预加载：用
client.User.Query().WithPosts().All(ctx)一次查出全部关联数据 - 手动批处理：若逻辑复杂，先取所有 user.IDs，再用
client.Post.Query().Where(post.UserIDIn(ids...)).All(ctx)批量查 - 别依赖
WithXxx()就万事大吉——它只解决一级关联，嵌套两层以上仍需手写优化
