symfony 4 模型迁移关键在“稳”，需四步：一、确认实体带@entity注解且database_url可写；二、用doctrine:schema:update --dump-sql验证映射，生成非空迁移文件；三、用--no-interaction和--allow-no-migration执行；四、手动验证表存在及migrations:status状态为up。
第一次用 Symfony 4 完成模型迁移，关键不是“快”，而是“稳”——确保实体定义正确、数据库连得上、生成的迁移不为空、执行时不卡住。下面四步走完，基本不会翻车。
一、先让实体和数据库配置对得上
别急着跑迁移命令，先确认两件事：
-
实体类必须带
@Entity注解（或 PHP 8.1+ 属性映射），且字段有@Column或类型声明；MakerBundle 生成的默认实体通常已满足，但手动改过要再检查一遍 -
.env里的DATABASE_URL指向可写的本地库，比如 SQLite：sqlite:///%kernel.project_dir%/var/data.db，或 MySQL：mysql://user:pass@127.0.0.1:3306/myapp；运行php bin/console doctrine:database:create --if-not-exists验证能建库
二、生成迁移文件前，先看 Doctrine 能不能“看见”变化
执行 php bin/console make:migration 前，建议先试跑一次：
-
php bin/console doctrine:schema:update --dump-sql—— 如果输出 SQL，说明实体和映射已就绪；如果提示 “No metadata found”，大概率是config/packages/doctrine.yaml没启用自动扫描，或实体没放在src/Entity/下 - 生成后立刻打开
migrations/Version*.php，确认up()方法里有$this->addSql()或$schema->createTable()；如果全是空函数，删掉重来，不要留着
三、执行迁移时关掉交互、允许无变更
Symfony 4 默认会问你“是否继续”，开发环境可以回车，但命令行脚本或后续部署会卡住：
- 用
php bin/console doctrine:migrations:migrate --no-interaction（简写-n）跳过确认 - 加
--allow-no-migration，避免当前已是最新版时命令返回失败码（CI/CD 必加） - 执行完检查数据库里是否多了
doctrine_migration_versions表，并有一条记录对应刚执行的版本号
四、验证表建成了，再动业务逻辑
别只信命令输出的 “migrated” 字样，亲手验证最可靠：
- SQLite：直接打开
var/data.db用 DB Browser 查表 - MySQL：用
php bin/console doctrine:query:sql "SHOW TABLES"看有没有你的实体名（如category、article） - 顺手跑
php bin/console doctrine:migrations:status，确认 “Executed migrations” 列表里包含你刚执行的那条，状态是up
