Symfony MakerBundle生成的Doctrine迁移异常删除现有索引问题

Doctrine生成迁移的逻辑是：分别读取「实体映射推导出来的预期Schema结构」和「通过information_schema读取的当前数据库实际结构」，逐对象对比差异生成SQL。出现仅删除索引、不重建的情况，唯一原因是对比逻辑判定：该索引存在于数据库中，但不存在于实体映射定义的预期结构里，属于需要删除的冗余对象，自然不会生成重建语句。
从你提供的Country表样例来看，实体注解里明确定义了对应索引，数据库里也实际存在同名索引，出现误判基本都是元数据读取环节的匹配偏差导致的。

• 首先核对索引标识符的完全匹配
  MariaDB的标识符大小写敏感规则受lower_case_table_names参数控制，很多环境下information_schema里存的索引名和你实体里写的大小写不完全一致（比如全小写存储，实体里写大写下划线命名），就会被判定为两个不同对象。先执行以下SQL查询当前库中相关表的实际索引名准确值：

  SELECT TABLE_NAME, INDEX_NAME FROM information_schema.STATISTICS 
  WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME IN ('Bank', 'ContactLog', 'Country', 'Lead', 'LeadTradeIn', 'WorkflowLog');
  

  把实体中#[ORM\Index]注解的name属性，和查询结果逐字符完全对齐（包括大小写、下划线位置），不要凭记忆写索引名。
• 对齐数据库连接的字符集、排序规则配置
  你提供的Country表实际排序规则是utf8mb3_unicode_ci，但自动生成的新建表语句默认用utf8mb4_unicode_ci，说明config/packages/doctrine.yaml里全局配置的默认字符集和存量表的实际字符集不一致。Schema对比时字符集、排序规则的不匹配会连带导致同名列上的索引被判定为属性不匹配，甚至直接识别失败。
  先把连接配置的字符集、默认表选项调整为和存量表一致的值，先消除配置差导致的误判，后续再统一做字符集升级：

  doctrine:
      dbal:
          default_connection: default
          connections:
              default:
                  # 先和现有库字符集对齐，消除差异
                  charset: utf8mb3
                  default_table_options:
                      charset: utf8mb3
                      collation: utf8mb3_unicode_ci
                  # 必须明确指定MariaDB版本，避免DBAL按MySQL规则解析元数据
                  server_version: 'mariadb-10.7'
  

• 检查索引属性的隐式差异
  对出现误删索引的表执行SHOW INDEX FROM 表名;，重点核对两个字段：
  • Index_type：确认索引类型和实体定义一致（普通索引为BTREE，不要被误识别成FULLTEXT/UNIQUE）
  • Sub_part：确认是否配置了索引前缀长度，如果有非空值，要在实体的Index注解的options里指定对应lengths参数
• 排查Schema过滤器配置错误
  检查doctrine配置里的schema_filter项，如果正则写得过于宽泛，会导致Doctrine读取数据库元数据时过滤掉部分合法索引，误以为这些索引没有被实体映射。正确的过滤器只需要排除你不需要Doctrine管理的第三方表即可，比如迁移版本表：

  doctrine:
      dbal:
          schema_filter: '/^(?!migration_versions)/'
  

• 修复已知的DBAL兼容问题
  你使用的doctrine/dbal 3.3.7版本对MariaDB 10.7的元数据读取存在已知bug，部分场景下会把关联表的外键索引、普通索引误判为冗余索引。可以直接升级dbal到3.3分支的最新小版本，兼容问题修复后不需要改动业务代码。

每次调整完配置或实体注解后，不要直接运行make:migration，先执行：

php bin/console doctrine:schema:update --dump-sql

检查输出的SQL列表，确认所有多余的DROP INDEX语句都消失后，再生成正式迁移文件。所有自动生成的迁移必须逐行审核SQL后再执行，避免误删索引影响线上查询性能。

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