升级Laminas项目后执行Doctrine命令报错：driverClass需实现指定接口

我将Laminas项目的doctrine-migrations从1.4版本升级至3.6，doctrine-orm-module从1版本升级至5.3后，在部署服务器上执行命令：

./vendor/bin/doctrine-module sync-metadata-storage

触发如下致命错误：

Fatal error: Uncaught Doctrine\DBAL\Exception: The given 'driverClass' Doctrine\DBAL\Driver\PDO\MySql\Driver has to implement the Doctrine\DBAL\Driver interface. in /var/www/vendor/doctrine/dbal/src/Exception.php:98
Stack trace:
#0 /var/www/vendor/doctrine/dbal/src/DriverManager.php(229): Doctrine\DBAL\Exception::invalidDriverClass('Doctrine\\DBAL\\D...')
#1 /var/www/vendor/doctrine/dbal/src/DriverManager.php(185): Doctrine\DBAL\DriverManager::createDriver(NULL, 'Doctrine\\DBAL\\D...')
#2 /var/www/vendor/doctrine/doctrine-orm-module/src/Service/DBALConnectionFactory.php(62): Doctrine\DBAL\DriverManager::getConnection(Array, Object(Doctrine\ORM\Configuration), Object(Doctrine\Common\EventManager))
#3 /var/www/vendor/doctrine/doctrine-module/src/ServiceFactory/AbstractDoctrineServiceFactory.php(41): DoctrineORMModule\Service\DBALConnectionFactory->__invoke(Object(Laminas\ServiceManager\ServiceManager), 'doctrine.connec...')
#4 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineModule\ServiceFactory\AbstractDoctrineServiceFactory->__invoke(Object(Laminas\ServiceManager\ServiceManager), 'doctrine.connec...', NULL)
#5 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): Laminas\ServiceManager\ServiceManager->doCreate('doctrine.connec...')
#6 /var/www/vendor/doctrine/doctrine-orm-module/src/Service/RunSqlCommandFactory.php(20): Laminas\ServiceManager\ServiceManager->get('doctrine.connec...')
#7 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineORMModule\Service\RunSqlCommandFactory->__invoke(Object(Laminas\ServiceManager\ServiceManager), 'doctrine.dbal_c...', NULL)
#8 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): Laminas\ServiceManager\ServiceManager->doCreate('doctrine.dbal_c...')
#9 /var/www/vendor/doctrine/doctrine-orm-module/src/CliConfigurator.php(81): Laminas\ServiceManager\ServiceManager->get('doctrine.dbal_c...')
#10 /var/www/vendor/doctrine/doctrine-orm-module/src/Module.php(39): DoctrineORMModule\CliConfigurator->configure(Object(Symfony\Component\Console\Application))
#11 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(320): DoctrineORMModule\Module::DoctrineORMModule\{closure}(Object(Laminas\EventManager\Event))
#12 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(143): Laminas\EventManager\EventManager->triggerListeners(Object(Laminas\EventManager\Event))
#13 /var/www/vendor/doctrine/doctrine-module/src/Service/CliFactory.php(52): Laminas\EventManager\EventManager->trigger('loadCli.post', Object(Symfony\Component\Console\Application), Array)
#14 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineModule\Service\CliFactory->__invoke(Object(Laminas\ServiceManager\ServiceManager), 'doctrine.cli', NULL)
#15 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): Laminas\ServiceManager\ServiceManager->doCreate('doctrine.cli')
#16 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module.php(44): Laminas\ServiceManager\ServiceManager->get('doctrine.cli')
#17 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module(4): include('/var/www/vendor...')
#18 /var/www/vendor/bin/doctrine-module(120): include('/var/www/vendor...')
#19 {main}
Next Laminas\ServiceManager\Exception\ServiceNotCreatedException: Service with name "doctrine.connection.orm_default" could not be created. Reason: The given 'driverClass' Doctrine\DBAL\Driver\PDO\MySql\Driver has to implement the Doctrine\DBAL\Driver interface. in /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php:627
Stack trace:
#0 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): Laminas\ServiceManager\ServiceManager->doCreate('doctrine.connec...')
#1 /var/www/vendor/doctrine/doctrine-orm-module/src/Service/RunSqlCommandFactory.php(20): Laminas\ServiceManager\ServiceManager->get('doctrine.connec...')
#2 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineORMModule\Service\RunSqlCommandFactory->__invoke(Object(Laminas\ServiceManager\ServiceManager), 'doctrine.dbal_c...', NULL)
#3 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): Laminas\ServiceManager\ServiceManager->doCreate('doctrine.dbal_c...')
#4 /var/www/vendor/doctrine/doctrine-orm-module/src/CliConfigurator.php(81): Laminas\ServiceManager\ServiceManager->get('doctrine.dbal_c...')
#5 /var/www/vendor/doctrine/doctrine-orm-module/src/Module.php(39): DoctrineORMModule\CliConfigurator->configure(Object(Symfony\Component\Console\Application))
#6 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(320): DoctrineORMModule\Module::DoctrineORMModule\{closure}(Object(Laminas\EventManager\Event))
#7 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(143): Laminas\EventManager\EventManager->triggerListeners(Object(Laminas\EventManager\Event))
#8 /var/www/vendor/doctrine/doctrine-module/src/Service/CliFactory.php(52): Laminas\EventManager\EventManager->trigger('loadCli.post', Object(Symfony\Component\Console\Application), Array)
#9 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineModule\Service\CliFactory->__invoke(Object(Laminas\ServiceManager\ServiceManager), 'doctrine.cli', NULL)
#10 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): Laminas\ServiceManager\ServiceManager->doCreate('doctrine.cli')
#11 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module.php(44): Laminas\ServiceManager\ServiceManager->get('doctrine.cli')
#12 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module(4): include('/var/www/vendor...')
#13 /var/www/vendor/bin/doctrine-module(120): include('/var/www/vendor...')
#14 {main}
  thrown in /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php on line 627

本地环境使用完全相同的composer.json配置、PHP版本及扩展，未出现该问题。已尝试清理各类缓存、删除vendor目录与composer.lock文件、重建Docker容器等常规调试步骤，问题仍未解决。

排查解决思路 #

• 核对DBAL版本兼容性：doctrine-orm-module 5.3对DBAL版本有明确要求，检查服务器上composer安装后实际生成的composer.lock中DBAL版本是否与本地一致，可执行composer show doctrine/dbal查看版本差异
• 修正数据库驱动类配置：升级后Doctrine DBAL的MySQL驱动类命名空间已变更，旧配置中的Doctrine\DBAL\Driver\PDO\MySql\Driver需替换为Doctrine\DBAL\Driver\PDOMySql\Driver，检查项目中Doctrine数据库连接配置文件（如config/autoload/doctrine.local.php）中的driverClass参数
• 验证PHP扩展加载：执行php -m命令确认服务器环境已加载pdo_mysql扩展，也可在项目中临时添加var_dump(extension_loaded('pdo_mysql'));exit;验证扩展状态
• 重建自动加载映射：执行composer dump-autoload -o重新生成优化后的类自动加载文件，解决可能存在的类路径映射错误
• 检查配置环境差异：对比本地与服务器的Doctrine配置文件，确认服务器端未手动指定错误的driverClass或其他冲突配置
• 确认文件权限：检查服务器上vendor/doctrine/dbal目录及子文件的权限，确保PHP进程拥有读取权限，避免因权限问题导致类文件无法加载

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