doctrine迁移失败主因是实体与数据库状态不一致，源于配置语义模糊（如postgresql误用autoincrement）、平台差异（sequence缺sequencename）、环境未校准（大小写敏感、连接配置错误）或状态表脱节。
迁移失败不是 Doctrine “坏了”，而是它在比对实体定义和数据库实际状态时，发现不一致——而这种不一致往往来自配置语义模糊、平台行为差异或环境未校准。
Doctrine:migrations:diff 检测不到变化或生成错误 SQL
常见现象是运行 php bin/console doctrine:migrations:diff 后没生成文件，或生成了删 ID 自增、改列类型等危险语句。
- 实体类缺
@ORM\Entity或@ORM\Table注解，Doctrine 直接跳过该类 - PostgreSQL 中误用
options={"autoincrement":true}：这个配置只对 MySQL 有效，PostgreSQL 忽略它，但 Doctrine 还是会把它当“元数据”参与 diff，导致前后两次比对结果矛盾 - 用了
strategy="SEQUENCE"却没写sequenceName，Doctrine 猜序列名，猜错后下次 diff 就“纠正”回普通整数列 - 数据库里已有表结构，但实体字段类型（如
type="string"）没配length，而 DBAL 推导出的长度与实际不符（比如 DB 里是 VARCHAR(255)，实体没声明 length，diff 可能认为要改）
迁移执行时报 “Table already exists” 或 “Relation does not exist”
这不是代码问题，是迁移状态表 doctrine_migration_versions 和数据库真实结构脱节了。
- 手动执行过 SQL（比如
CREATE TABLE），但没在迁移文件里记录，doctrine:migrations:migrate再次尝试建表就会报 “already exists” - 迁移文件被删了、重命名了，或
doctrine_migration_versions表里多了一条记录但对应文件不存在，状态就卡住 - 多环境共用一个数据库（比如本地开发连了测试库），别人跑了迁移但你没同步文件，
status就显示 “up to date”，其实结构已变 - PostgreSQL 下表名大小写敏感，实体用
@ORM\Table(name="User")但数据库里是user，schema 比对直接失败
迁移命令执行中断或连接拒绝
这类失败和 Doctrine 逻辑无关，纯属基础设施没对齐。
-
DATABASE_URL里写localhost：Docker 或云环境必须换成服务名（如database）或内网 IP，否则 PHP 进程连不上 - 密码含
@、/、:没 URL 编码，parse_url()截断连接串，最终连到错误地址 - PHP 没装对应扩展（
pdo_pgsql或pdo_mysql），命令直接报 Class not found - 防火墙/安全组没放行数据库端口（
5432或3306），doctrine:database:create都通不过
最麻烦的点往往藏在“看起来没问题”的地方：比如 PostgreSQL 实体用了 strategy="IDENTITY"，但旧表还挂着序列，diff 不报错，migrate 却在 ALTER COLUMN 时因权限或依赖关系失败——这时候得先手动 DROP SEQUENCE，再跑迁移。
