Typo3扩展激活后系统崩溃页面空白，无法访问前后台

看来你在TYPO3扩展开发和部署上踩了几个坑，别慌，咱们一步步解决：

一、先恢复系统前后台访问权限 #

你移动扩展文件夹后系统仍报错，大概率是TYPO3缓存里还残留着这个扩展的注册信息，得先清缓存：

• 清除文件缓存：直接删除typo3temp/目录下的所有文件和子文件夹（如果有.gitignore文件可以保留）
• 清除数据库缓存：登录你的数据库管理工具（比如phpMyAdmin），找到所有以cache_开头的表（比如cache_pages、cache_hash、cache_extensions），清空这些表的数据
• CLI方式（如果可用）：如果你的TYPO3是Composer安装的，在项目根目录执行命令：typo3cms cache:flush，一键清空所有缓存

做完这些后，再尝试访问前后台，应该能恢复正常了。

二、排查Tx_Extbase_Utility_Extension找不到的问题 #

这个类找不到的核心原因是TYPO3版本不兼容：

• 在TYPO3 6.x及更早版本，Extbase类使用Tx_前缀的旧命名方式（比如Tx_Extbase_Utility_Extension）
• 从TYPO3 7.x开始，官方全面切换到PSR-4命名空间，对应的类变成了\TYPO3\CMS\Extbase\Utility\ExtensionUtility

你用的教程大概率是针对旧版本TYPO3的，而当前系统版本更高，所以会报错。解决方法：

1. 先确认你的TYPO3版本：可以看typo3/sysext/core/Classes/Core/SystemEnvironmentBuilder.php文件里的版本常量，或者恢复系统后在后台查看版本号
2. 把扩展代码里所有的Tx_Extbase_Utility_Extension替换成\TYPO3\CMS\Extbase\Utility\ExtensionUtility
3. 同时检查扩展里其他Tx_前缀的类，是否都需要替换成对应命名空间的类（比如Tx_Extbase_Domain_Repository_*要改成\TYPO3\CMS\Extbase\Domain\Repository\*）

三、调试首次安装的“Oops. Error”无详细信息问题 #

默认情况下TYPO3生产环境会隐藏详细错误，开启调试模式就能看到具体报错：

1. 打开typo3conf/LocalConfiguration.php文件
2. 修改以下配置（如果没有就添加）：

   'BE' => [
       'debug' => true,
   ],
   'FE' => [
       'debug' => true,
   ],
   'SYS' => [
       'devIPmask' => '*', // 测试环境可以设为*，生产环境要改成你的IP
       'displayErrors' => 1,
       'errorHandlerErrors' => E_ALL ^ E_NOTICE ^ E_WARNING,
       'exceptionalErrors' => E_ALL ^ E_NOTICE ^ E_WARNING,
   ],
   

3. 保存后再尝试安装扩展，就能看到具体的错误提示（比如依赖缺失、代码语法错误等）

四、扩展安装的注意事项 #

• 确保扩展目录结构符合当前TYPO3版本的规范：至少要有ext_emconf.php（扩展配置文件）、ext_localconf.php（后端配置）、ext_tables.php（数据库表注册）这几个核心文件
• 如果是Composer安装的TYPO3，建议通过Composer加载扩展（composer require your-vendor/your-extension），而不是手动放到typo3conf/ext目录下，避免自动加载问题

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