Doctrine ORM中findOneBy传入有效ID却返回null的问题

1. 检查自定义Repository的findOneBy重写逻辑 #

如果MyEntity有自定义Repository类（比如MyEntityRepository），排查是否重写了findOneBy方法。错误的重写逻辑（比如额外添加了未满足的过滤条件）会导致返回null：

// 错误示例：额外添加固定过滤条件导致不符合条件的记录无法被查询
class MyEntityRepository extends ServiceEntityRepository
{
    public function findOneBy(array $criteria, array $orderBy = null)
    {
        $criteria['status'] = 1; // 若目标记录status不为1，findOneBy会返回null
        return parent::findOneBy($criteria, $orderBy);
    }
}

2. 验证ID类型与实体映射的匹配性 #

确认传入的$id类型和实体中id属性的映射类型完全一致：

• 比如实体id映射为integer，但传入的$id是字符串类型（如"123"），Doctrine的findBy系列方法不会自动转换类型，会导致查询无结果；而QueryBuilder的参数绑定会自动适配类型。
• 排查方式：输出gettype($id)，对比实体映射里的id字段类型，确保两者一致。

3. 检查实体是否启用全局过滤规则 #

如果实体使用了软删除扩展（如Gedmo SoftDeleteable）或自定义全局过滤条件：

• findOneBy会自动应用这些全局规则，而手动编写的QueryBuilder如果未加入对应过滤条件，会查询到被过滤的记录。
• 验证方法：在QueryBuilder中加入相同过滤条件，观察是否还能查到结果：

$qb = $this->em->createQueryBuilder();
$test2 = $qb->select('t')
    ->from(MyEntity::class, 't')
    ->where('t.id = :id')
    ->andWhere('t.deletedAt IS NULL') // 模拟软删除过滤规则
    ->setParameter('id', $id)
    ->getQuery()->getSingleResult();

若此时QueryBuilder也返回null，说明目标记录已被标记为过滤状态（如已软删除）。

4. 清理Doctrine缓存 #

Doctrine的元数据缓存或查询缓存可能导致findOneBy使用旧的映射规则，执行以下命令清理缓存：

php bin/console cache:clear
php bin/console doctrine:cache:clear-metadata
php bin/console doctrine:cache:clear-query

5. 检查实体ID字段的映射正确性 #

确认MyEntity中id字段的注解配置无错误，比如是否正确标记主键、类型是否与数据库匹配：

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: MyEntityRepository::class)]
class MyEntity
{
    #[ORM\Id]
    #[ORM\GeneratedValue(strategy: 'IDENTITY')]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;

    // 其他字段...
}

若id未标记@Id或类型配置错误，findOneBy无法正确识别主键字段，会导致查询失效。

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