TYPO3后台模块Dependency Injection失效问题求助

1. 修复composer自动加载配置 #

手动修改composer.json后，必须保证命名空间与目录的PSR-4映射正确，且更新自动加载缓存：

• 检查autoload区块，确保命名空间Peni4142\ImageCompressor对应Classes/目录：

  "autoload": {
    "psr-4": {
      "Peni4142\\ImageCompressor\\": "Classes/"
    }
  }
  

• 执行命令行指令composer dump-autoload更新自动加载缓存，这是手动修改composer后的必要操作。

2. 规范控制器的DI写法 #

Extbase控制器的依赖注入必须遵循框架规则：

• 控制器类必须继承\TYPO3\CMS\Extbase\Mvc\Controller\ActionController
• 构造函数注入时，必须调用父类构造函数，且注入的参数必须是容器可识别的服务类：

  use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
  use Peni4142\ImageCompressor\Service\YourService;
  
  class ImageCompressorController extends ActionController
  {
      public function __construct(
          private readonly YourService $yourService
      ) {
          parent::__construct(); // 必须调用父类构造
      }
  }
  

• 禁止手动实例化控制器，必须由Extbase的DI容器负责实例化。

3. 核对模块配置文件 #

确保ext_localconf.php和ext_tables.php中的模块配置正确关联Extbase：

• ext_localconf.php中的模块注册要使用Extbase的配置方法：

  \TYPO3\CMS\Extbase\Utility\ExtensionUtility::configureModule(
      'ImageCompressor',
      'tools',
      'bottom',
      '',
      [
          'ImageCompressor' => 'index,compress', // 对应控制器的动作
      ],
      [
          'access' => 'admin',
          'icon' => 'EXT:image_compressor/Resources/Public/Icons/module-icon.svg',
          'labels' => 'LLL:EXT:image_compressor/Resources/Private/Language/locallang_mod.xlf',
      ]
  );
  

• 确认扩展密钥、模块标识与实际代码一致，无拼写错误。

4. 确保自定义服务被容器注册 #

如果注入的是自定义服务，需让TYPO3 DI容器识别它：

• 自定义服务类放在Classes/Service/等符合PSR-4的目录下
• 要么给服务类添加#[AsService]注解，要么在Configuration/Services.yaml中配置批量扫描：

  services:
    _defaults:
      autowire: true
      autoconfigure: true
      public: false
  
    Peni4142\ImageCompressor\:
      resource: '../Classes/*'
  

• 执行TYPO3缓存清理：后台点击「清除所有缓存」，或命令行执行typo3 cache:flush

5. 匹配TYPO3版本的DI规则 #

不同TYPO3版本的DI方式有差异：

• TYPO3 v11+推荐构造函数注入，v10及以下需使用inject*方法（例如public function injectYourService(YourService $yourService)）
• 若使用属性注入，需确保属性添加#[Inject]注解（仅适用于特定版本）

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