Akeneo Pim自定义Bundle注入CategoryRepository服务失败求助

问题原因 #

Akeneo基于Symfony构建，容器编译时会对部分服务做优化（比如内联处理），pim_catalog.repository.category这类Repository服务默认可能未公开，或者被自动配置的类型绑定覆盖，直接引用服务ID会导致容器找不到对应实例，进而出现构造函数参数缺失的错误。

解决方案 #

1. 基于接口注入（推荐） #

Akeneo的pim_catalog.repository.category是Pim\Bundle\CatalogBundle\Repository\CategoryRepositoryInterface的实现类，直接在服务配置中注入接口而非硬编码服务ID：

# 自定义Bundle的services.yaml或项目根目录config/services.yaml
App\EventListener\CategoryBuilder:
    tags:
        - { name: kernel.event_listener, event: akeneo.storage.post_save }
    arguments:
        - '@Pim\Bundle\CatalogBundle\Repository\CategoryRepositoryInterface'

如果你的Bundle开启了自动注入（autowire: true），甚至可以省略arguments配置，只要CategoryBuilder的构造函数参数声明为该接口即可：

namespace App\EventListener;

use Pim\Bundle\CatalogBundle\Repository\CategoryRepositoryInterface;

class CategoryBuilder
{
    public function __construct(
        private CategoryRepositoryInterface $categoryRepository
    ) {}

    // 事件处理逻辑...
}

2. 显式绑定接口与服务ID #

如果自动注入不生效，可以在配置中显式将接口绑定到对应的服务ID，并设置服务为公开：

services:
    Pim\Bundle\CatalogBundle\Repository\CategoryRepositoryInterface:
        alias: pim_catalog.repository.category
        public: true

这样容器就能明确找到接口对应的服务实例，避免因内联优化导致的服务不可用。

3. 验证服务配置 #

执行以下命令确认接口对应的服务是否存在且配置正确：

php bin/console debug:container Pim\Bundle\CatalogBundle\Repository\CategoryRepositoryInterface

4. 清理并预热缓存 #

确保缓存完全清理后再执行预热操作：

# 清理缓存
php bin/console cache:clear
# 预热缓存（生产环境推荐）
php bin/console cache:warmup

注意事项 #

• 优先使用接口注入而非具体服务ID，Akeneo版本迭代中接口的稳定性远高于服务ID。
• 确认自定义Bundle的services.yaml开启了autoconfigure: true和autowire: true，这能大幅简化依赖注入配置。

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