Symfony 7.0自定义Bundle实体仓库服务加载失败问题排查

问题重现 #

将现有Symfony 7.0应用封装为自定义Bundle时，通过EntityManager::getRepository(MyEntity::class)调用实体仓库时触发错误：

"TBD\CustomBundle\Repository\MyEntityRepository"实体仓库实现了"Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepositoryInterface"，但未找到其服务，请确保服务存在并标记"doctrine.repository_service"

Bundle的services.xml已配置服务并添加标签，但仅在应用的services.yaml中显式配置时才能正常加载。Bundle配置片段：

<services>
    <service
        id="tbd_custom.my_entity_repository"
        class="TBD\CustomBundle\Repository\MyEntityRepository"
        public="true"
        autowire="true"
    >
        <tag name="doctrine.repository_service" />
        <argument type="service" id="doctrine"></argument>
    </service>

    <!-- Alias -->
    <service 
        id="TBD\CustomBundle\Repository\MyEntityRepository"
        alias="tbd_custom.my_entity_repository"
    />
</services>

调试时通过debug:container发现，Bundle中配置的别名服务被容器编译优化移除，而应用级配置的服务无此问题。

问题根源 #

1. 别名服务未设为公开：Symfony容器编译时会自动移除未标记为public="true"的别名服务，而Doctrine是通过类全名作为服务ID查找仓库的，找不到对应服务就会报错。
2. （可选）构造参数注入风险：如果仓库继承ServiceEntityRepository，构造函数需要的是ManagerRegistry（对应服务IDdoctrine），而非直接注入EntityManager，当前参数配置正确，但后续修改容易踩坑。

解决方案 #

方案1：修正别名服务的公开属性 #

给Bundle中的别名服务添加public="true"，避免被容器优化移除：

<services>
    <service
        id="tbd_custom.my_entity_repository"
        class="TBD\CustomBundle\Repository\MyEntityRepository"
        public="true"
        autowire="true"
    >
        <tag name="doctrine.repository_service" />
        <argument type="service" id="doctrine"></argument>
    </service>

    <!-- 标记别名为公开 -->
    <service 
        id="TBD\CustomBundle\Repository\MyEntityRepository"
        alias="tbd_custom.my_entity_repository"
        public="true"
    />
</services>

方案2：直接用类全名作为服务ID（推荐） #

删除别名配置，直接将类全名设为服务ID，简化配置同时避免别名优化问题：

<services>
    <service
        id="TBD\CustomBundle\Repository\MyEntityRepository"
        class="TBD\CustomBundle\Repository\MyEntityRepository"
        public="true"
        autowire="true"
    >
        <tag name="doctrine.repository_service" />
        <argument type="service" id="doctrine"></argument>
    </service>
</services>

方案3：自动扫描+自动配置（最优） #

利用Symfony的自动扫描和自动配置特性，无需手动逐个配置仓库：

<services>
    <!-- 开启默认自动注入、自动配置，私有服务默认不对外暴露 -->
    <defaults autowire="true" autoconfigure="true" public="false" />
    
    <!-- 扫描Repository目录下所有类，强制设为公开（Doctrine需要从容器中获取） -->
    <prototype namespace="TBD\CustomBundle\Repository\" resource="../Repository/*" public="true" />
</services>

说明：开启autoconfigure="true"后，Symfony会自动给实现ServiceEntityRepositoryInterface的类添加doctrine.repository_service标签，同时自动注入ManagerRegistry，无需手动配置。

验证方法 #

运行以下命令确认服务存在且配置正确：

php bin/console debug:container TBD\CustomBundle\Repository\MyEntityRepository

输出中需包含：public = true、Tags = doctrine.repository_service。

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