TYPO3从v9.5.31升级到v10.4.20后前端报FlexFormService类不存在错误

根本原因 #

TYPO3 从v10版本开始对核心类命名空间做了重构，原位于TYPO3\CMS\Extbase\Service下的FlexFormService类已经被正式迁移到TYPO3\CMS\Core\Service命名空间下，v9版本的旧类路径在v10中被完全移除，因此调用旧类名的代码会抛出类不存在的错误。

触发逻辑 #

• 后台运行正常是因为后台执行的业务逻辑没有涉及到调用旧类路径的代码
• 前端页面渲染时触发了自定义扩展/第三方扩展中调用旧类的逻辑，因此仅前端报错

修复方案 #

• 全局扫描所有站点内的自定义扩展、第三方扩展代码，搜索TYPO3\CMS\Extbase\Service\FlexFormService字符串
• 将所有旧命名空间引用替换为新的命名空间TYPO3\CMS\Core\Service\FlexFormService
• 若存在依赖注入配置（Services.yaml/Services.php）中引用了旧类，同步更新对应配置
• 全部修改完成后清空TYPO3所有缓存，包括核心缓存、自动加载缓存、前端页面缓存
• 如果调用旧类的是第三方扩展，优先升级该扩展到适配TYPO3 v10的官方版本，可避免同类兼容性问题

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