symfony 3 数据库迁移失败需逐层排查：先确认 migration 文件是否生成且含有效 sql，再验证 database_url 配置、数据库权限与 pdo_mysql 扩展，接着检查 doctrine_migration_versions 表是否存在及状态，最后审查 down() 方法兼容性与反向操作完整性。
Symfony 3 的数据库迁移命令执行失败，通常不是单一原因导致的，而是多个环节中某一处出了问题。重点先看 doctrine:migrations:migrate 是否能正常运行，再逐层排查。
检查迁移文件是否生成成功
迁移命令失败，有时根本不是执行问题，而是迁移文件压根没生成或内容为空。
- 运行
php bin/console make:migration后，检查migrations/目录下是否生成了以时间戳命名的 PHP 文件 - 打开该文件，确认
up()方法里有实际 SQL 操作（比如$this->addSql('CREATE TABLE ...')），而不是空方法或注释占位 - 如果使用了 Doctrine ORM 实体变更自动生成迁移，确保实体类已正确映射（
@ORM\Entity、字段类型标注等），且运行前执行过php bin/console doctrine:cache:clear-metadata清理元数据缓存
验证数据库连接和权限
Symfony 3 依赖 .env 中的 DATABASE_URL 连接数据库，配置错误或权限不足会导致迁移直接中断。
- 确认
.env中DATABASE_URL格式正确，例如：DATABASE_URL="mysql://root:pass@127.0.0.1:3306/myapp?serverVersion=5.7" - 本地开发务必用
127.0.0.1，不用localhost（避免 socket 连接失败） - 运行
php bin/console doctrine:database:create --if-not-exists测试建库权限；若报Access denied，说明用户缺少CREATE权限，需手动授权 - 检查 PHP 是否启用了
pdo_mysql扩展：php -m | grep pdo_mysql
确认迁移状态表是否正常
Doctrine 依靠 doctrine_migration_versions 表记录已执行的迁移版本。这张表损坏或缺失，会导致“无迁移可执行”或重复执行。
- 连接数据库，查看是否存在
doctrine_migration_versions表；若不存在，可手动创建：CREATE TABLE doctrine_migration_versions (version VARCHAR(106) NOT NULL PRIMARY KEY, executed_at DATETIME NOT NULL COMMENT "(DC2Type:datetime_immutable)"); - 执行
php bin/console doctrine:migrations:status，观察输出是否列出迁移文件及状态（Yes/No） - 如果状态显示全部为
No，但迁移文件存在，可能是表结构不匹配或字符集问题（建议使用utf8mb4）
排查 down() 方法引发的回滚失败
即使只是执行 migrate，如果之前执行过部分迁移又中途失败，Doctrine 可能尝试回滚脏状态，此时 down() 写错就会卡住。
- 检查最近一次迁移的
down()方法：是否删除了up()中未创建的对象？是否用了不兼容语法（如DROP TABLE IF EXISTS在旧版 Doctrine 不支持）？ - 涉及数据变更（
INSERT/UPDATE）的迁移，down()必须提供对应反向操作，不能留空 - 不确定时，先在开发环境加
--dry-run参数测试：php bin/console doctrine:migrations:migrate --dry-run，预览将执行的 SQL
