Symfony中Doctrine Schema Update拟删除migration_versions表问题

doctrine_migration_versions是Doctrine Migrations组件的核心表，用于记录已执行的数据库迁移历史，正常情况下doctrine:schema:update --complete不应该将其标记为待删除对象。以下是可能的原因和对应的解决方法：

1. Doctrine未排除系统维护表 #

doctrine:schema:update基于实体映射元数据对比数据库结构，由于doctrine_migration_versions不属于用户定义的实体，若未在配置中排除该表，Doctrine会将其判定为冗余表。

解决方法：
在config/packages/doctrine.yaml中添加schema过滤规则，让Doctrine忽略该表：

doctrine:
    dbal:
        # 过滤doctrine_migration_versions表，避免被schema:update误处理
        schema_filter: ~^(?!doctrine_migration_versions)$~

2. Doctrine Migrations组件未正确配置 #

如果Migrations组件未在Symfony中正确注册或配置，Doctrine无法识别该表为系统维护表，从而标记为待删除。

解决方法：

• 确认组件已安装：在容器内执行命令composer show doctrine/doctrine-migrations-bundle，若未安装则运行composer require doctrine/doctrine-migrations-bundle。
• 检查Bundle注册：确保config/bundles.php中存在以下条目：

  Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle::class => ['all' => true],
  

• 验证Migrations配置：检查config/packages/doctrine_migrations.yaml是否正确指定了表名：

  doctrine_migrations:
      migrations_paths:
          'DoctrineMigrations': '%kernel.project_dir%/migrations'
      storage:
          table_storage:
              table_name: doctrine_migration_versions
              version_column_name: version
              version_column_length: 1024
              executed_at_column_name: executed_at
              execution_time_column_name: execution_time
  

3. Docker环境下的元数据缓存问题 #

容器内的Doctrine元数据缓存未更新，导致配置变更未被读取，从而误判表的必要性。

解决方法：
在容器内执行以下命令清除缓存：

# 清除Symfony应用缓存
php bin/console cache:clear
# 清除Doctrine元数据缓存
php bin/console doctrine:cache:clear-metadata

完成上述操作后，重新执行doctrine:schema:update --complete --dump-sql，确认输出中不再包含删除doctrine_migration_versions表的语句。

内容的提问来源于stack exchange，提问作者Sakshi_Goraniya