TYPO3从V9.5.31升级至V10.4.21前端报错及类无法识别问题求助

你提到的两个报错成因分别如下：

1. GuzzleHttp\Exception\ConnectException 报错 #

(1/1) GuzzleHttp\Exception\ConnectException
cURL error 7: Failed to connect to 2607:f8b0:4020:805::200a: Network is unreachable
该报错的核心成因：

• 上述报错中的地址是IPv6地址，你的服务器/运行环境未开启IPv6支持，或对应目标地址的IPv6网络路由不可达
• TYPO3 v10对内置的GuzzleHttp请求组件默认配置做了调整，优先使用IPv6解析域名，v9版本默认优先走IPv4，所以升级前不会触发该问题
• 可通过修改TYPO3全局Guzzle配置，添加CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V4参数强制走IPv4解析，即可临时解决该问题

2. TYPO3无法识别类报错 #

该问题的常见成因：

• TYPO3 v10移除了所有v9版本中标记为废弃的核心类，同时调整了部分核心类的命名空间，如果你安装的第三方扩展、自行开发的自定义扩展仍在调用旧版本类名/旧命名空间，就会触发类不存在的报错
• 升级操作完成后未清空TYPO3全部缓存，尤其是自动加载缓存：类映射表没有随版本更新，导致已存在的类无法被正常识别
• 若你使用的是非Composer模式部署的TYPO3实例，升级时核心文件覆盖不完整，会导致部分类文件缺失，触发类识别失败问题

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