Doctrine迁移通过自动对比实体与数据库生成可版本控制的PHP类，常用doctrine:migrations:diff或make:migration命令；需确保实体映射正确、数据库连接可用、迁移目录可写；生成文件含up()/down()方法，用$schema编程式操作以保证跨库兼容。
Doctrine迁移在Symfony中创建非常直接，核心是让框架自动对比实体变化与数据库现状，生成可版本控制的PHP迁移类。关键不在于手写SQL，而在于用命令触发智能差异识别。
生成迁移文件的两种主流方式
实际开发中主要用以下任一命令，效果一致，只是触发逻辑略有不同：
- doctrine:migrations:diff —— 最常用。它扫描当前所有Doctrine实体（含注解、属性映射或YAML配置），再连接数据库读取真实表结构，自动生成包含CREATE/ALTER/DROP语句的迁移类。
- make:migration —— Symfony Maker Bundle提供，底层调用的仍是diff逻辑，但会额外检查是否已安装MigrationsBundle，并提示缺失依赖。适合新手项目快速起步。
执行前必须确认的三件事
生成命令能正常运行，依赖以下基础就绪：
- 实体类已正确定义映射（比如用@ORM\Entity和@ORM\Column）且能被Doctrine识别；
- 数据库连接配置正确（DATABASE_URL环境变量或doctrine.dbal配置项可用）；
- 迁移目录已存在且可写（默认为src/Migrations，路径由migrations_paths配置控制）。
生成后迁移文件长什么样？
运行命令后，会在迁移目录下生成类似Version20260511173000.php的文件。它是一个标准PHP类，继承AbstractMigration，必须实现两个方法：
- up()：定义“升级”操作，比如创建新表、添加字段、修改索引；
- down()：定义“回滚”操作，逻辑需与up严格可逆（如dropTable对应createTable）。
内容不是原始SQL，而是通过$schema对象编程式构建，确保跨数据库兼容性。
常见问题与应对
如果生成失败或结果不符合预期，优先排查：
- 实体新增了字段但没加@ORM\Column，diff会忽略该变更；
- 数据库里存在未被Doctrine管理的表（如日志表、第三方插件表），可通过schema_filter配置过滤（例如~^(?!t_).*~忽略以t_开头的表）；
- 已有数据库非空，首次集成时建议先运行doctrine:migrations:sync-metadata-storage初始化元数据表，再用diff生成基线迁移。
