为何Doctrine的find()方法会返回Proxy对象与真实实体对象两种结果？

在运行Symfony 5.4.*与doctrine/doctrine-bundle ^2.6的项目中，调用两个结构一致的Repository的find()方法时，一个返回Proxy对象，另一个返回真实Entity对象，无法定位差异原因，求排查思路。

测试控制器代码 #

public function startAction(InstitutionRepository $institutionRepository, CountryRepository $countryRepository): Response
{
    $result = $institutionRepository->find(266);
    $result2 = $countryRepository->find(1);
    return $this->json([$result, $result2]);
}

Institution实体代码 #

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * Institutions.
 *
 * @ORM\Table(name="institutions")
 *
 * @ORM\Entity(repositoryClass="App\Repository\InstitutionRepository")
 */
class Institution
{
    /**
     * @var int
     *
     * @ORM\Column(name="institution", type="integer", nullable=false)
     *
     * @ORM\Id
     *
     * @ORM\GeneratedValue(strategy="IDENTITY")
     */
    private $id;

    /**
     * @var string
     *
     * @ORM\Column(name="code", type="string", length=10, nullable=false)
     */
    private $code;

    /**
     * @var string
     *
     * @ORM\Column(name="name", type="string", length=255, nullable=false)
     */
    private $name;
    public function getId(): int
    {
        return $this->id;
    }
    public function setId(int $id): void
    {
        $this->id = $id;
    }
    public function getCode(): string
    {
        return $this->code;
    }
    public function setCode(string $code): void
    {
        $this->code = $code;
    }
    public function getName(): string
    {
        return $this->name;
    }
    public function setName(string $name): void
    {
        $this->name = $name;
    }
}

Country实体代码 #

<?php

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * Countries.
 *
 * @ORM\Table(name="countries", uniqueConstraints={@ORM\UniqueConstraint(name="code", columns={"code"})})
 *
 * @ORM\Entity(repositoryClass="App\Repository\CountryRepository")
 */
class Country
{
    /**
     * @var int
     *
     * @ORM\Column(name="country", type="integer", nullable=false)
     *
     * @ORM\Id
     *
     * @ORM\GeneratedValue(strategy="IDENTITY")
     */
    private $id;

    /**
     * @var string
     *
     * @ORM\Column(name="code", type="string", length=10, nullable=false)
     */
    private $code;

    /**
     * @var string
     *
     * @ORM\Column(name="name", type="string", length=45, nullable=false)
     */
    private $name;

    /**
     * Get id.
     *
     * @return int
     */
    public function getId()
    {
        return $this->id;
    }

    /**
     * Set code.
     *
     * @param string $code
     *
     * @return Country
     */
    public function setCode($code)
    {
        $this->code = $code;

        return $this;
    }

    /**
     * Get code.
     *
     * @return string
     */
    public function getCode()
    {
        return $this->code;
    }

    /**
     * Set name.
     *
     * @param string $name
     *
     * @return Country
     */
    public function setName($name)
    {
        $this->name = $name;

        return $this;
    }

    /**
     * Get name.
     *
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }
}

CountryRepository代码 #

<?php

declare(strict_types=1);

namespace App\Repository;

use App\Entity\Country;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;

/**
 * @extends ServiceEntityRepository<Country>
 */
class CountryRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, Country::class);
    }
}

InstitutionRepository代码 #

<?php

declare(strict_types=1);

namespace App\Repository;

use Database\OrganisationBundle\Entity\Institution;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;

/**
 * @extends ServiceEntityRepository<Country>
 */
class InstitutionRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, Institution::class);
    }
}

序列化结果 #

[
  {
    "id": 266,
    "code": "LGSE_QS_IN",
    "name": "LGSE QS Test Institution",
    "__initializer__": null,
    "__cloner__": null,
    "__isInitialized__": true
  },
  {
    "id": 1,
    "code": "AF",
    "name": "Afghanistan"
  }
]

排查思路 #

• 修复Repository的明显错误：
  1. InstitutionRepository的@extends注释错误，应改为@extends ServiceEntityRepository<Institution>而非<Country>，注释错误会导致Doctrine元数据解析异常。
  2. InstitutionRepository引入的实体命名空间错误：实体类Institution在App\Entity下，但Repository中使用use Database\OrganisationBundle\Entity\Institution;，会导致Doctrine加载错误的实体类，直接引发代理生成逻辑异常。
• 清理Doctrine元数据缓存：执行bin/console doctrine:cache:clear-metadata，清除可能存在的旧缓存配置，确保Doctrine使用最新的实体映射。
• 检查实体提前加载情况：查看请求流程中是否有其他逻辑提前加载了Country实体（比如关联查询、缓存读取），此时find()会直接返回已存在于EntityManager中的真实对象；而Institution未被提前加载，因此返回Proxy对象（即使序列化时触发了初始化，仍会保留Proxy相关字段）。
• 检查Doctrine代理配置：查看config/packages/doctrine.yaml中的代理配置，确认proxy_dir、proxy_namespace是否正常，是否存在针对特定实体的特殊配置。
• 验证序列化规则：检查Symfony序列化组件对两个实体的处理是否一致，比如是否为Institution配置了特殊序列化组，或实体是否实现Serializable接口的方式不同。
• 核对数据库映射：确认两个实体的字段映射与数据库表结构完全匹配，比如ID字段的列名、类型是否正确，避免因映射错误导致Doctrine处理逻辑差异。

内容的提问来源于stack exchange，提问作者Wolf-Tech