Symfony实体字段需Doctrine映射配置（注解/YAML/XML）与PHP属性共同定义，仅添加属性无效；主键须成对使用@ORM\Id和@ORM\GeneratedValue；关联需双向正确配置mappedBy/inversedBy；默认值须数据库级配置；全链路识别是关键。
Symfony 实体字段不是“手动添加”的，而是由 Doctrine 映射定义 + PHP 属性共同构成的。直接在类里加一个 $foo 属性不会自动变成数据库字段，必须配合映射配置（注解、YAML 或 XML）才能被 Doctrine 识别并参与迁移、查询、持久化。
实体字段必须声明映射元数据
Doctrine 不会扫描所有 public/private 属性来猜测哪些该进数据库。哪怕你写了 private $status，没配 @ORM\Column 或对应 YAML 字段定义，它就只是个普通 PHP 属性，不参与 ORM 生命周期。
- 注解方式最常用：
#[ORM\Column(type: 'string', length: 255)]
必须紧贴属性声明上方 - YAML 配置需严格匹配类名和字段名，且放在
config/doctrine/Entity.orm.yaml类似路径下 - XML 需遵守 Doctrine 的 XSD 结构，
<field name="status" type="string"/>缺一不可 - 漏掉
type（如string、datetime_immutable）会导致迁移失败或类型推断错误
#[ORM\Id] 和 #[ORM\GeneratedValue] 必须成对出现
主键字段如果用自增，不能只写 #[ORM\Id]，否则 Doctrine 会报错 MappingException: No identifier/primary key specified，即使数据库里已有 id 列。
- 正确写法：
#[ORM\Id] #[ORM\GeneratedValue] #[ORM\Column]
- 如果主键是 UUID 或业务生成的，改用
#[ORM\GeneratedValue(strategy: 'NONE')]，并确保构造时赋值 - 复合主键极少见，需用
#[ORM\Id]标多个字段，且必须全部有#[ORM\Column]
关联字段（ManyToOne、OneToMany）要双向配清 mappedBy / inversedBy
漏配或配反会导致 Association not defined 或保存时外键为 NULL —— 这是新手最常踩的坑，不是代码逻辑错，是映射关系断了。
-
ManyToOne端必须设inversedBy="comments"（指向对方集合属性名） -
OneToMany端必须设mappedBy="post"（指向对方单对象属性名） - 两边的属性名必须拼写完全一致，大小写敏感
- 若只想要单向关联（比如只从
Comment查Post），就只配ManyToOne，别硬加OneToMany
字段默认值不能只靠 PHP 构造函数
像 $createdAt = new \DateTimeImmutable() 这种写法，在新实体实例化时有效，但 Doctrine 从数据库 hydrate 出来时不会执行构造函数，字段会是 null —— 所以必须用 @ORM\Column(options: ['default' => 'CURRENT_TIMESTAMP'])（数据库级）或 #[ORM\Column(type: 'datetime_immutable', options: ['default' => 'CURRENT_TIMESTAMP'])] 配合迁移生效。
- PHP 层默认值仅影响 new Entity() 场景，不保证 DB 层一致
-
datetime_immutable类型必须配options: ['default' => 'CURRENT_TIMESTAMP']，不能写'now()'（MySQL 不认） - 想让字段“一次写入不可改”，除了构造函数赋值，还得去掉 setter 方法，否则调用
$entity->setCreatedAt(...)仍可覆盖
真正关键的不是“怎么加字段”，而是“加完之后是否被 Doctrine 全链路识别”：从类定义 → 映射解析 → 数据库 schema → 查询 hydrate，每一步断掉都会表现为字段丢失、NULL 值、迁移失败或 DQL 报错。检查时优先跑 php bin/console doctrine:schema:validate，比翻文档更快定位映射问题。
