Symfony监听器无法访问实体仓库自定义方法问题求助

看起来你遇到的问题是：在Authentication事件监听器中调用User仓库的自定义方法countByUsername时失败，但把相同逻辑的代码直接写在UserTransfer中就能正常运行。这种情况通常和仓库实例的获取方式、依赖注入配置或者事务上下文有关，下面是几个常见的排查方向和解决办法：

1. 确认监听器中是否正确获取了UserRepository实例 #

很多时候监听器里如果是通过EntityManager获取仓库，可能因为实体映射的问题拿到的是默认的EntityRepository而非你自定义的仓库类。

错误示例： #

// 监听器中错误的获取方式，可能拿到默认仓库
$em = $this->entityManager;
$userRepo = $em->getRepository(User::class);
// 此时$userRepo可能不是你的自定义UserRepository，所以没有countByUsername方法

正确做法： #

首先确保你的自定义仓库类正确继承ServiceEntityRepository，并且在实体类上配置了仓库类：

// User.php
namespace PortalBundle\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity(repositoryClass="PortalBundle\Repository\UserRepository")
 */
class User
{
    // ... 实体字段
}

然后在监听器中通过依赖注入直接注入UserRepository，而不是通过EntityManager获取：

// UserAuthenticationListener.php（你的监听器类）
namespace PortalBundle\EventListener;

use PortalBundle\Entity\User;
use PortalBundle\Repository\UserRepository;
use Symfony\Component\Security\Core\Event\AuthenticationEvent;

class UserAuthenticationListener
{
    private $userRepository;

    // 构造函数注入自定义仓库
    public function __construct(UserRepository $userRepository)
    {
        $this->userRepository = $userRepository;
    }

    public function onAuthentication(AuthenticationEvent $event)
    {
        // 现在可以正常调用自定义方法
        $count = $this->userRepository->countByUsername('test');
        // ... 后续插入数据逻辑
    }
}

2. 检查自定义仓库方法的实现是否正确 #

确保你的UserRepository中的countByUsername方法没有语法错误，并且正确继承了父类：

// UserRepository.php
namespace PortalBundle\Repository;

use PortalBundle\Entity\User;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;

class UserRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, User::class);
    }

    public function countByUsername(string $username): int
    {
        return $this->createQueryBuilder('u')
            ->select('COUNT(u.id)')
            ->where('u.username = :username')
            ->setParameter('username', $username)
            ->getQuery()
            ->getSingleScalarResult();
    }
}

3. 排查事务上下文问题 #

监听器触发的时机（比如AuthenticationEvent）可能处于一个未提交的事务中，或者EntityManager的状态和UserTransfer中不同。可以尝试在调用仓库方法前刷新EntityManager，或者确保操作在正确的事务边界内：

public function onAuthentication(AuthenticationEvent $event)
{
    // 如果需要，先刷新EntityManager状态
    $this->entityManager->flush();
    $count = $this->userRepository->countByUsername('test');
    // ... 插入数据逻辑
    $this->entityManager->persist($yourEntity);
    $this->entityManager->flush();
}

4. 检查依赖注入配置（Symfony版本较低时） #

如果你的Symfony版本低于4.0，可能需要手动在services.yaml中配置监听器的依赖注入：

# config/services.yaml
services:
    PortalBundle\EventListener\UserAuthenticationListener:
        arguments:
            $userRepository: '@PortalBundle\Repository\UserRepository'
        tags:
            - { name: kernel.event_listener, event: security.authentication.success, method: onAuthentication }

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