TYPO3 13.1.1自定义插件前端输出报错求助

1. 命名空间不匹配错误 #

ext_localconf.php中引入的控制器命名空间是MyCompany\Controller\ProductSpaceController，但实际控制器文件的命名空间为Company\Controller，两者不一致导致TYPO3无法定位控制器类。

修复：
修改ext_localconf.php中的use语句：

use Company\Controller\ProductSpaceController;

2. Action方法返回值不符合TYPO3 13规范 #

TYPO3 12+版本要求Extbase控制器的Action方法必须返回ResponseInterface类型，直接返回字符串会触发响应处理异常。

修复：
调整ProductSpaceController.php的testAction方法，返回标准响应对象：

<?php

namespace Company\Controller;
use TYPO3\CMS\Core\Http\HtmlResponse;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;

class ProductSpaceController extends ActionController
{
    public function testAction(): HtmlResponse
    {
        return new HtmlResponse('Hello World!');
    }
}

3. 可选：缺失对应Fluid模板的处理 #

如果希望使用传统视图渲染方式而非直接返回响应，需创建对应模板文件：

• 在扩展目录下创建Resources/Private/Templates/ProductSpace/Test.html
• 模板内容直接写入：Hello World!

此时控制器方法可改为：

public function testAction()
{
    // 无需返回值，系统会自动渲染对应模板
}

4. 验证扩展Key一致性 #

确认ExtensionUtility::configurePlugin的第一个参数'company'与你的扩展实际Key完全匹配（可查看composer.json的name字段或ext_emconf.php的extension_key值）。

5. 强制清理缓存 #

修改代码后，必须在TYPO3后台执行全量缓存清理，包括配置缓存和自动加载缓存，确保新配置与代码生效。

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