Doctrine 实体类不更新主因是元数据缓存未清、PostgreSQL 中 options={"autoincrement":true} 无效或 strategy="SEQUENCE" 缺少 sequenceName；推荐改用 strategy="IDENTITY" 并执行 cache:clear 后 migrations:diff。
Doctrine 实体类不更新，通常不是 Symfony 版本问题，而是 Doctrine 的元数据缓存、迁移生成逻辑或数据库结构与实体定义不一致导致的——尤其在 PostgreSQL 环境下高频出现。
doctrine:migrations:diff 生成空迁移或忽略字段变更
执行 php bin/console doctrine:migrations:diff 后没生成预期 SQL，或只生成了无关语句，常见于以下情况：
- 实体类修改后未清除 Doctrine 缓存：
php bin/console cache:clear必须执行，否则migrations:diff仍基于旧元数据比对 - 字段类型变更未被识别：例如把
@ORM\Column(type="string", length=191)改成length=255，Doctrine 默认不追踪 length 变更（除非显式启用--full-database或配置doctrine.orm.auto_mapping: true） - PostgreSQL 中使用了
options={"autoincrement":true}—— 该配置在 PG 中完全无效，migrations:diff会反复“修正”它，最终表现为字段“没更新”或 ID 策略异常
实体字段改了但数据库表没变，且 migrate 执行无报错
这说明 Doctrine 认为当前数据库结构与实体定义“一致”，但实际可能隐含不兼容项：
- ID 主键用了
strategy="SEQUENCE"却没配sequenceName：Doctrine 首次迁移可能自动生成序列，但后续 diff 无法匹配，于是跳过变更 - 推荐统一改用
strategy="IDENTITY"（PostgreSQL 10+ 原生支持），并删掉所有options={"autoincrement":true}—— 这是 Symfony 7.3 + Doctrine 5.2+ 下最稳定的做法 - 检查
doctrine.dbal.url是否指向正确数据库；本地 .env 中误配了 SQLite 而实际想改 PostgreSQL 表，也会导致 diff 完全不生效
修改实体后 php bin/console doctrine:schema:update --force 不起作用
这个命令在 Symfony 7.3 中默认已被弃用（仅保留兼容），且它绕过 migrations 机制，容易掩盖结构偏差：
- 它不会处理序列、IDENTITY 列、约束或索引变更，尤其对 PostgreSQL 的
GENERATED BY DEFAULT AS IDENTITY列完全无感知 - 若实体中用了
@ORM\UniqueConstraint或@ORM\Index，schema:update很可能静默忽略 - 真正可靠的流程是：改实体 →
cache:clear→migrations:diff→ 检查生成的迁移文件内容 →migrations:migrate
最容易被忽略的一点：Doctrine 对 PostgreSQL 的列默认值（如 nextval('xxx_seq'::regclass)）和 IDENTITY 列的元数据识别逻辑完全不同。一旦混用 SEQUENCE + autoincrement 或在 migration 中手动写了 ALTER COLUMN，后续 diff 就极易失准——这不是 bug，是设计使然。别依赖“看起来一样”，要确保实体注解、数据库实际结构、migration 文件三者语义严格对齐。
