Symfony执行make:migration时出现SQL字段歧义异常

错误原因 #

这个错误是因为Doctrine生成的SQL查询里，多个表都包含TABLE_NAME字段，WHERE子句没明确指定该字段属于哪个表，导致数据库无法区分，触发完整性约束冲突。即便删除了User实体及仓库，缓存残留、旧迁移记录或第三方扩展配置，仍可能让Doctrine生成存在歧义的查询。

解决步骤 #

• 清除Doctrine元数据缓存：执行php bin/console doctrine:cache:clear-metadata，强制Doctrine重新加载实体元数据，避免旧缓存引发的表名冲突。
• 清理迁移版本表：登录数据库，找到migration_versions表，删除所有和已移除实体相关的旧迁移记录，再重新执行php bin/console make:migration。
• 检查第三方Doctrine扩展：如果用了软删除、审计日志类扩展，排查其配置或实体注解，确认是否存在未指定表名的查询逻辑，导致TABLE_NAME字段歧义。
• 重置数据库（仅适用于无重要数据的场景）：依次执行php bin/console doctrine:database:drop --force、php bin/console doctrine:database:create，彻底重置后再尝试生成迁移。
• 核对版本兼容性：确认Symfony与Doctrine ORM、Doctrine Migrations的版本是否匹配，部分旧版本组件存在此类查询bug，升级到兼容版本即可解决。

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