Zend 3 & Doctrine报错：服务解析失败及getServiceLocator插件未找到

嘿，这俩问题我之前在做Zend和Doctrine的项目时也碰到过，都是Zend MVC 3以后依赖注入机制变化带来的坑，给你一步步拆解解决：

第一个错误：无法解析Book控制器的工厂 #

“Unable to resolve service "BookList\Controller\Book" to a factory; are you certain you provided it during configuration?”

这个错误的核心是Zend MVC要求所有控制器必须注册对应的工厂类，尤其是当你的控制器需要依赖Doctrine的EntityManager这类服务时，不能再像老版本那样自动实例化了。

解决步骤：

1. 在module.config.php里注册控制器工厂
   打开你的模块配置文件，找到controllers节点，给Book控制器指定工厂类：

   'controllers' => [
       'factories' => [
           BookList\Controller\BookController::class => BookList\Factory\BookControllerFactory::class,
       ],
   ],
   

   注意这里要写完整的类名，避免命名空间冲突。

2. 创建控制器工厂类
   在你的模块目录下新建Factory/BookControllerFactory.php，实现FactoryInterface来注入EntityManager：

   namespace BookList\Factory;
   
   use BookList\Controller\BookController;
   use Doctrine\ORM\EntityManager;
   use Interop\Container\ContainerInterface;
   use Zend\ServiceManager\Factory\FactoryInterface;
   
   class BookControllerFactory implements FactoryInterface
   {
       public function __invoke(ContainerInterface $container, $requestedName, array $options = null)
       {
           // 从服务容器中获取Doctrine的EntityManager
           $entityManager = $container->get(EntityManager::class);
           // 把EntityManager注入到控制器的构造函数
           return new BookController($entityManager);
       }
   }
   

3. 修改Book控制器，通过构造函数接受依赖
   把原来控制器里用getServiceLocator()获取EntityManager的代码删掉，换成构造注入：

   namespace BookList\Controller;
   
   use Doctrine\ORM\EntityManager;
   use Zend\Mvc\Controller\AbstractActionController;
   
   class BookController extends AbstractActionController
   {
       private $entityManager;
   
       // 通过构造函数注入EntityManager
       public function __construct(EntityManager $entityManager)
       {
           $this->entityManager = $entityManager;
       }
   
       // 比如你的列表页action，直接用$this->entityManager操作数据库
       public function listAction()
       {
           $books = $this->entityManager->getRepository(Book::class)->findAll();
           return ['books' => $books];
       }
   }
   

第二个错误：找不到getServiceLocator插件 #

‘A plugin by the name “getServiceLocator” was not found in the plugin manager Zend\Mvc\Controller\PluginManager’

这个错误是因为Zend MVC 3已经弃用了控制器的getServiceLocator()方法，这个方法不再是控制器的默认插件了，官方推荐用依赖注入（也就是上面的构造注入方式）来传入服务，而不是在控制器里直接从容器拿。

解决方法：

• 如果你之前在控制器里写了类似$this->getServiceLocator()->get(EntityManager::class)的代码，直接删掉，换成上面的构造注入方式，这是最规范的做法。
• 如果实在有临时需求（不推荐），可以让控制器实现ServiceLocatorAwareInterface并使用对应的Trait，但这只是过渡方案：

  use Zend\ServiceManager\ServiceLocatorAwareInterface;
  use Zend\ServiceManager\ServiceLocatorAwareTrait;
  
  class BookController extends AbstractActionController implements ServiceLocatorAwareInterface
  {
      use ServiceLocatorAwareTrait;
  
      // 临时使用的话可以这么写，但还是建议构造注入
      public function someAction()
      {
          $entityManager = $this->getServiceLocator()->get(EntityManager::class);
      }
  }
  

  不过真心建议用构造注入，这才是Zend MVC 3以后的最佳实践，也能避免这类插件找不到的问题。

总的来说，这俩错误都是围绕Zend MVC的依赖注入机制，只要把控制器的工厂配置和依赖注入弄对，问题就解决了！

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