TYPO3 11.2.0升级11.5.0后Form扩展与前端EXT:路径报错问题

问题背景 #

TYPO3 11.5.0版本新增了多项资源与配置严格校验规则，从低于11.5的版本直接升级后容易触发兼容性报错，你遇到的两类报错属于11.5升级常见问题。

前端报错：503 - Resource paths must start with "EXT:" and must reference Resources/Public #

该报错由11.5新增的资源路径强制校验机制触发，仅允许通过EXT:协议引用扩展Resources/Public目录下的公开资源，排查步骤：

• 核查所有TypoScript资源引入配置：包括page.includeJS、page.includeCSS、page.includeJSFooter等配置项，所有扩展资源路径必须符合EXT:<扩展标识>/Resources/Public/<资源路径>格式，禁止直接引用Resources/Private目录下的资源，禁止使用相对路径、本地绝对路径引入扩展资源
• 核查Fluid模板中f:uri.resource、f:asset.script、f:asset.style标签的path属性，必须以Resources/Public开头
• 排查自定义扩展的全局配置文件（如ext_emconf.php、ext_localconf.php）中是否存在不符合规则的资源注册逻辑

后端报错：503 - TYPO3.CMS.Form.mixins.formElementMixins.FormElementMixin does not exist #

该报错由11.5版本Form框架配置结构调整触发，排查步骤：

• 核查站点包、自定义扩展中所有Form相关YAML配置：11.5版本中原TYPO3.CMS.Form.mixins命名空间下的全局mixin已全部迁移至TYPO3.CMS.Form.prototype下定义，直接引用旧的mixin路径会触发配置不存在错误
• 若使用第三方Form相关扩展，确认扩展是否已发布11.5兼容版本，未兼容的扩展会保留旧mixin引用逻辑导致冲突
• 手动执行rm -rf var/cache/*清空全部缓存文件，部分场景下后台全缓存清理不会清除旧的YAML配置缓存

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