在 Symfony 6.4 中创建有效数据迁移，必须确保实体类已正确定义并被 Doctrine 识别，配置 doctrine.dbal.url 指向可写数据库，启用 auto_mapping，使用 doctrine:migrations:diff 生成含 addSql() 的迁移文件，执行前需验证迁移内容非空，再通过 migrate 或 execute 命令同步结构。
在 Symfony 6.4 项目中创建数据迁移，必须先有实体类定义且 Doctrine 能识别其映射关系，否则生成的迁移文件为空或报“No changes detected”——这不是命令问题，而是元数据未加载导致的静默失败，后续执行 migrate 会跳过该文件却无任何提示。
确认实体与数据库配置就绪
打开 config/packages/doctrine.yaml，检查 doctrine.dbal.url 是否指向一个可写的本地数据库（如 sqlite:///%kernel.project_dir%/var/data.db），【若 URL 为空、格式错误或指向只读实例，make:migration 将无法获取当前库结构，必然生成空迁移】。
运行 php bin/console doctrine:database:create --if-not-exists 创建数据库（SQLite 自动建文件，此步可跳过）。
确保至少一个实体类使用 @Entity 注解或 PHP 8.1+ 属性映射，并位于 src/Entity/ 下；同时确认 config/doctrine.yaml 中已启用自动扫描：
doctrine:<br> orm:<br> auto_mapping: true
生成迁移文件（推荐用 diff）
方法一：基于实体变更自动生成差异迁移
修改你的实体类（例如给 User 加一个 $phone 属性并配好 @Column(type: "string", nullable: true)），保存后执行：php bin/console doctrine:migrations:diff
该命令会比对当前实体定义与数据库实际结构，生成带时间戳的 migrations/Version*.php 文件，up() 中含 $this->addSql() 调用。
方法二：强制生成空白迁移（仅调试或初始化用）php bin/console make:migration
注意：它不检测变更，只生成骨架文件。若实体未改或未被识别，文件里 up() 和 down() 都是空函数体——这种文件不能删，但也不能直接 migrate，否则会被跳过。
生成后立刻打开迁移文件，确认 $this->addSql(...) 存在且非空；【若为空，说明 Doctrine 没识别到实体变更，请先运行 php bin/console doctrine:schema:update --dump-sql 查看是否有预期 SQL，没有就检查注解或映射路径】。
执行迁移同步表结构
第一步：查看待执行状态php bin/console doctrine:migrations:status
确认 “Available migrations” 列表中包含你刚生成的版本号，且 “Executed migrations” 里还没有它。
第二步：执行全部待处理迁移php bin/console doctrine:migrations:migrate
命令会自动创建 doctrine_migration_versions 表（若不存在），然后逐条运行 up() 方法。
第三步：仅执行最新一条（适合调试）php bin/console doctrine:migrations:execute --up 'DoctrineMigrations\Version20260807051400'
类名需替换为实际生成的迁移类全限定名，可在 migrations/ 目录下找到。
生产环境部署时必须加 --no-interaction -n 参数，否则卡在交互式确认环节；CI/CD 还应加 --allow-no-migration，避免无新迁移时返回非零退出码导致流水线中断。
