安装TYPO3 CMS出现params must be mixed错误如何修复

报错场景 #

本地XAMPP环境部署TYPO3 CMS时触发如下错误：

Type of TYPO3\CMS\Core\IO\CsvStreamFilter::$params must be mixed (as in class php_user_filter) in C:\xampp\htdocs\typo3test\example-project-directory\public\typo3\sysext\core\Classes\IO\CsvStreamFilter.php on line 26

报错指向第26行类定义代码：

class CsvStreamFilter extends \php_user_filter

已尝试操作：修改文件内declare(strict_types=1)为declare(strict_types=0)，但修改内容会被自动覆盖，无法生效。

错误原因 #

这是典型的PHP版本与TYPO3版本不兼容问题：PHP 8.1及以上版本调整了内置php_user_filter类的$params属性类型声明为mixed，当前安装的TYPO3版本未适配该类型要求，开启严格类型时直接抛出类型不匹配错误。
直接修改核心文件里的strict_types声明不生效是正常现象：TYPO3核心文件会在缓存刷新、版本更新、依赖安装时自动还原为官方原始版本，直接修改核心文件本身就是错误操作，不建议使用。

修复方案 #

按优先级选择操作即可：

• 最稳妥方案：核对安装的TYPO3版本对应的PHP版本要求，如果是TYPO3 v11及更早版本，直接把XAMPP的PHP版本切换到8.0即可彻底解决。旧版TYPO3没有做PHP 8.1+的全量适配，就算绕过这个报错，后续还会出现其他同类兼容问题。
• 长期使用方案：如果必须用PHP 8.1及以上版本，把TYPO3升级到v12及以上正式稳定版，官方已经在新版本中完成了PHP 8.1+的类型适配，不需要手动修改任何代码。
• 临时测试方案（仅本地调试用，禁止用于生产环境）：打开报错提示的CsvStreamFilter.php文件，在类内部补全和父类一致的属性声明，类开头部分代码修改为如下形式即可：

class CsvStreamFilter extends \php_user_filter
{
    public mixed $params;

    // 类内原有其余代码保持不变
}

修改完成后删除TYPO3项目下var/cache目录内的所有缓存文件刷新即可生效。注意后续如果执行框架更新、缓存刷新操作，该修改会被覆盖，还是建议优先用前两种版本匹配的方案彻底解决。

提示：不要通过关闭严格类型模式绕过报错，这类类型不匹配问题可能在后续运行中触发更难排查的逻辑错误。

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