Symfony 2.8.52 默认不内置 Doctrine Migrations，需手动安装 doctrine/doctrine-migrations-bundle:^1.3 并在 AppKernel 中注册；首次使用执行 doctrine:migrations:diff 生成迁移文件，再通过 doctrine:migrations:migrate 执行，全程事务保护。
在 Symfony 2.8.52 中执行数据库迁移，不使用 Doctrine Migrations Bundle 的原生命令（如 doctrine:migrations:migrate），因为该功能在 2.8 时代默认未内置——它需额外安装 doctrine/doctrine-migrations-bundle。若你尚未安装，直接运行迁移命令会报错 Command "doctrine:migrations:migrate" does not exist。
以下是完整、可落地的操作路径：
✅ 确认是否已启用 Doctrine Migrations Bundle
检查 app/AppKernel.php 是否注册了该 Bundle：
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle(),
);
}同时确认 composer.json 中包含：
"require": {
"doctrine/doctrine-migrations-bundle": "^1.3"
}⚠️ Symfony 2.8 兼容的是 Migrations Bundle v1.x（非 3.x/4.x）。运行
composer require doctrine/doctrine-migrations-bundle:^1.3安装。
✅ 初始化迁移环境（首次使用）
php app/console doctrine:migrations:generate --db-configuration=app/config/config.yml
或更常用方式（自动生成基于当前 schema 差异的迁移类）：
php app/console doctrine:migrations:diff
该命令会在 app/DoctrineMigrations/ 下生成类似 Version20261020113000.php 的文件。
✅ 执行迁移
php app/console doctrine:migrations:migrate
默认执行到最新版本。也可指定版本：
php app/console doctrine:migrations:migrate 20261020113000
✅ 常见问题速查
-
“No migrations to execute”：说明数据库
migration_versions表中已记录当前版本，或diff未检测到 schema 变化。可手动删掉刚生成的空迁移文件，或检查doctrine:schema:update --dump-sql是否真有差异。 -
表不存在或字段冲突：确保
app/config/config.yml中doctrine.dbal.mapping_types配置与实际数据库类型一致（尤其 PostgreSQL 或 MySQL 5.7+ 的json类型）。 -
权限错误：CLI 运行用户需对
app/cache/和app/logs/有写权限（Linux/macOS 下常需chmod -R 777 app/cache app/logs或用setfacl）。
迁移操作本质是按序执行 PHP 类中的 up() 方法（SQL DDL 操作），所有语句包裹在事务中，失败则自动回滚。
不复杂但容易忽略。
