symfony 4跨版本迁移冲突本质是数据库schema状态与migrations目录记录不匹配，需对齐状态、避免重复、安全推进；常见类型包括重复时间戳文件、已执行未记录、未执行却被标记完成及diff生成错误sql。
Symfony 4 跨版本迁移时，迁移文件冲突通常不是“代码合并”问题，而是执行顺序错乱、状态不一致或重复生成导致的。Doctrine Migrations 不支持 Git 式的文本合并，它的冲突本质是数据库 schema 状态与 migrations 目录记录不匹配。解决重点不在“怎么合并文件”，而在“如何对齐状态、避免重复、安全推进”。
识别真实冲突类型
先确认你遇到的是哪一类问题：
-
重复时间戳迁移文件：多人协作时生成了相同时间戳（如
Version20260730100000.php），Git 合并后目录里出现两个同名文件 —— 这属于命名冲突，需人工删一留一； -
已执行但未记录的迁移：某台机器手动改了表、没走 migration 命令，导致
doctrine_migration_versions表缺失该条记录 —— 执行migrate会报错“Table already exists”； -
未执行却已被标记为完成：误运行了
mark_as_migrated或数据库被重置，但 migration 文件还在 —— 再执行migrate会跳过，造成结构遗漏； -
diff 生成空迁移或覆盖式 SQL：实体改了但数据库已有对应字段，
doctrine:migrations:diff却生成了ADD COLUMN—— 说明 Doctrine 元数据缓存未清理或映射注解不完整。
安全处理重复/冲突迁移文件
若已出现多个同名或相近时间戳的迁移文件（例如 Version20260730100000.php 和 Version20260730100001.php）：
- 打开两个文件，对比
up()中的$this->addSql()内容 —— 如果 SQL 完全一致，只保留一个，另一个直接删除； - 如果 SQL 不同（比如 A 加字段、B 改索引），不要强行合并，而是新建一个整合版：
php bin/console doctrine:migrations:generate，手动把两条变更写进新文件的up()； - 删除旧文件后，运行
php bin/console doctrine:migrations:sync-metadata-storage（Symfony 5.4+）或php bin/console doctrine:migrations:version --add [version]（旧版），确保元数据表与文件系统一致。
修复状态不一致（最常见真冲突）
当 php bin/console doctrine:migrations:status 显示 “Executed” 数量 ≠ 文件数，或提示 “No migrations to execute”，但数据库明显缺字段：
- 先运行
php bin/console doctrine:schema:validate，确认当前实体映射与数据库是否一致； - 若验证失败，且知道缺失哪些变更，用
php bin/console doctrine:migrations:diff重新生成 —— 注意加--configuration=指定正确配置，多连接时加--em=default； - 若 diff 仍为空，清缓存：
php bin/console cache:clear+rm -rf var/cache/*，再试； - 切勿直接删
doctrine_migration_versions表或手动执行 SQL —— 正确做法是用php bin/console doctrine:migrations:execute --down [version]回退，再migrate重放，前提是down()方法已正确定义。
预防后续冲突的实操习惯
跨版本长期演进中，靠“合并”不如靠“隔离+规范”：
- 所有迁移必须由
doctrine:migrations:diff生成，禁用手写（除非极特殊场景）； - 团队约定：每天上班第一件事，先
git pull+php bin/console doctrine:migrations:migrate，再开始开发； - CI 流程中加入
doctrine:migrations:status --show-versions检查，防止未提交迁移文件被漏掉； - 升级 Symfony 主版本（如 4.4 → 5.4）前，先确保所有 migration 已执行完毕、
status显示 clean，再更新依赖。
