TYPO3 v12.4出现No TypoScript record found 500错误的解决方法

这个错误的核心原因是TYPO3前端渲染时找不到有效的TypoScript配置记录，以下是针对性的解决步骤：

1. 检查根页面的TypoScript模板配置 #

TYPO3必须在站点根页面（最顶层页面，通常带有地球图标）上配置根级TypoScript模板：

• 登录后端，切换到「模板」模块
• 确保选中的是你的站点根页面，点击「创建新模板」并选择「创建根级别的模板」
• 编辑模板，在「设置」标签中添加基础渲染配置（全新安装可使用以下默认配置）：

# 基础页面渲染配置
page = PAGE
page.typeNum = 0

# 使用Fluid模板渲染
page.10 = FLUIDTEMPLATE
page.10 {
    templateName = Default
    templateRootPaths.10 = EXT:site_package/Resources/Private/Templates/Page/
    partialRootPaths.10 = EXT:site_package/Resources/Private/Partials/
    layoutRootPaths.10 = EXT:site_package/Resources/Private/Layouts/
    
    # 处理导航菜单
    dataProcessing {
        10 = TYPO3\CMS\Frontend\DataProcessing\MenuProcessor
        10 {
            levels = 1
            as = mainnavigation
        }
    }
}

• 保存模板后，点击「模板」模块顶部的「激活」按钮确保模板生效

2. 验证站点配置关联 #

• 切换到「站点管理」模块，确认已创建站点且根页面选择正确
• 检查站点的「域名」设置是否与你访问的mywebsite.localhost一致

3. 清除所有缓存 #

• 点击后端右上角的清除缓存图标，选择「全部清除」
• Docker环境下若仍有问题，可进入PHP容器执行命令手动清除缓存：

cd example-project-directory
./vendor/bin/typo3 cache:flush

4. 检查页面访问权限 #

• 编辑出错的页面，切换到「访问」标签
• 确保页面未被设置为「隐藏」，且「访问权限」允许匿名用户访问（取消勾选「限制访问」）

5. 确认Site Package扩展状态 #

使用cms-base-distribution安装的TYPO3默认包含官方Site Package扩展，需确认：

• 进入「扩展管理」模块，搜索site_package并确保其已启用
• 若未找到，可通过Composer安装：

composer require typo3/cms-sitepackage

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