在 TYPO3 11.5+ 中，直接通过构造函数注入 Psr\Log\LoggerInterface 会导致 ArgumentCountError，因其核心控制器与事件监听器由容器以非标准方式实例化；正确做法是依赖 LogManager 获取专用 Logger 实例。
在 typo3 11.5+ 中，直接通过构造函数注入 `psr\log\loggerinterface` 会导致 `argumentcounterror`，因其核心控制器与事件监听器由容器以非标准方式实例化；正确做法是依赖 `logmanager` 获取专用 logger 实例。
在 TYPO3 扩展开发中，为 XClass（如继承 NewRecordController）或事件监听器（如 AfterFileAddedEvent）添加日志功能时，不能简单沿用标准依赖注入模式——这是许多开发者踩坑的根源。根本原因在于：TYPO3 核心控制器（如 \TYPO3\CMS\Backend\Controller\NewRecordController）和部分事件监听器并非完全由 Symfony DI 容器管理，其构造函数参数由框架硬编码传入（例如 ServerRequestInterface、ModuleTemplate 等），而你自定义的 LoggerInterface 参数无法被自动解析，从而触发 ArgumentCountError。
✅ 正确方案：使用 LogManager 获取 Logger
TYPO3 提供了专为扩展设计的日志管理机制：通过注入 \TYPO3\CMS\Core\Log\LogManager，再调用 getLogger($className) 方法获取类型安全、上下文明确的 logger 实例。该方式兼容 XClass 和事件监听器，且符合 TYPO3 最佳实践。
示例 1：XClass 中注入 Logger（扩展 NewRecordController）
<?php
namespace Vendor\Project\Xclass;
use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Core\Log\LogManager;
use TYPO3\CMS\Backend\Controller\NewRecordController;
class NewRecordController extends \TYPO3\CMS\Backend\Controller\NewRecordController
{
protected \TYPO3\CMS\Core\Log\Logger $logger;
public function __construct(LogManager $logManager)
{
// 调用父类构造函数（必须显式传递其所需参数）
parent::__construct(
$GLOBALS['TYPO3_REQUEST'] ?? null,
// 其他父类必需参数（根据 TYPO3 版本调整，v11.5+ 通常只需 request）
);
$this->logger = $logManager->getLogger(self::class);
}
protected function renderNewRecordControls(ServerRequestInterface $request): void
{
$this->logger->warning('New record control rendered for user: ' . $this->getBackendUser()->user['username']);
parent::renderNewRecordControls($request);
}
}⚠️ 注意：XClass 构造函数需显式调用 parent::__construct() 并传入父类所需参数（如 $request）。若不确定参数列表，请查阅对应 TYPO3 版本的源码（如 NewRecordController::__construct() 签名）。
示例 2：事件监听器中使用 LogManager
<?php
namespace Vendor\Project\EventListener;
use TYPO3\CMS\Core\Log\LogManager;
use TYPO3\CMS\Core\Resource\Event\AfterFileAddedEvent;
class ManuscriptAdded
{
protected \TYPO3\CMS\Core\Log\Logger $logger;
public function __construct(LogManager $logManager)
{
$this->logger = $logManager->getLogger(self::class);
}
public function __invoke(AfterFileAddedEvent $event): void
{
$file = $event->getFile();
$this->logger->info('Manuscript added: {fileName}', [
'fileName' => $file->getName()
]);
}
}配套 Configuration/Services.yaml（无需额外配置，autowire 自动生效）：
services:
_defaults:
autowire: true
autoconfigure: true
public: false
Vendor\Project\EventListener\ManuscriptAdded:
tags:
- name: event.listener
identifier: 'msAdded'
event: TYPO3\CMS\Core\Resource\Event\AfterFileAddedEvent? 关键要点总结
- ❌ 不要在 XClass 或事件监听器中直接注入 Psr\Log\LoggerInterface —— 这会破坏 TYPO3 的实例化流程；
- ✅ 始终使用 LogManager：它是 TYPO3 日志系统的官方入口，确保 logger 具备正确的上下文（如 extKey、className）和处理器配置；
- ? XClass 构造函数必须兼容父类签名：先调用 parent::__construct(...)，再初始化自定义属性；
- ? 事件监听器无需 public: true：autowire: true + 正确 tags 即可被容器识别，public: false 更安全；
- ? 日志级别建议：debug/info 用于追踪，warning 表示异常但可恢复，error/critical 用于严重故障。
通过以上方式，你既能获得结构清晰、可追溯的日志输出，又能完全避免 ArgumentCountError，确保扩展在 TYPO3 11.5 及更高版本中稳定运行。
