Symfony 4.3升级5.4报setSchemaIgnoreClasses()未定义错误

错误根因 #

报错Call to undefined method Doctrine\ORM\Configuration::setSchemaIgnoreClasses()由Doctrine组件版本不匹配导致：

• setSchemaIgnoreClasses()是Doctrine ORM 2.10.0及以上版本才提供的方法
• 现有composer.json中Doctrine依赖约束过于宽松，实际安装的doctrine/orm版本低于2.10，但已安装的Doctrine Bundle在容器编译阶段会调用该方法，直接触发PHP致命错误
• 网传“该错误仅出现在doctrine-bundle 2.7.0版本”的表述不准确，只要Bundle代码调用了该方法、ORM版本未达到最低要求，任意Bundle版本都会触发同类错误。此前卸载重装Doctrine相关Bundle未生效，核心原因是未同步调整doctrine/orm的版本约束，低版本ORM始终被保留。

修复步骤 #

• 手动删除所有旧缓存文件，规避残留编译容器的干扰，不要使用当前无法正常运行的cache:clear命令，直接执行：

rm -rf var/cache/*

• 调整composer.json中Doctrine相关依赖的版本约束，对齐到Symfony 5.4兼容的版本区间：
  • 将"doctrine/doctrine-bundle": "^2.0"修改为"doctrine/doctrine-bundle": "^2.7"
  • 将"doctrine/orm": "^2"修改为"doctrine/orm": "^2.14"
  • 将"doctrine/doctrine-migrations-bundle": "^2"修改为"doctrine/doctrine-migrations-bundle": "^3.2"
    上述版本最低兼容PHP 7.1，完全适配当前配置的php: ^7.2.5运行要求，不会产生版本冲突。
• 执行依赖更新命令，同步升级所有Doctrine关联组件：

composer update doctrine/doctrine-bundle doctrine/orm doctrine/doctrine-migrations-bundle --with-all-dependencies

• 依赖更新完成后，执行生产环境缓存清理命令验证修复结果：

php bin/console cache:clear --env=prod

注意事项 #

不要手动修改var/cache目录下自动生成的容器PHP文件，这类文件是依赖安装、缓存预热流程自动生成的，手动修改后下次编译会被直接覆盖，无法从根源解决问题。

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