TYPO3新手求助：TypoScript无法渲染子页面内容问题排查

作为TypoScript新手，遇到这种无输出的情况很常见，咱们一步步来排查问题：

首先，你的代码缺少了关键的CONTENT对象定义，而且没有指定如何渲染查到的页面数据——这是导致无输出的核心原因。TypoScript中要从数据库读取并渲染内容，必须明确使用CONTENT对象来封装查询和渲染逻辑。

接下来，咱们拆解问题，给出修正后的代码和排查步骤：

1. 补全基础CONTENT对象结构 #

你的原始代码没有包裹在CONTENT对象里，TS引擎无法识别这是一个数据库查询操作。先把结构调整为：

archiveSubpages = CONTENT
archiveSubpages {
    # 包裹所有子页面内容的容器
    stdWrap.wrap = <div class="row"> | </div>

    # 查询pages表
    table = pages
    select {
        orderBy = sorting
        # 从当前归档页面的子页面中查询（确保上下文能获取到当前页面uid）
        pidInList.field = uid
        begin = 0
        # 过滤掉未发布、隐藏、删除的页面，只取普通内容页面
        where = doktype = 1 AND hidden = 0 AND deleted = 0
    }

    # 关键：定义每条子页面的渲染逻辑（renderObj）
    renderObj = COA
    renderObj {
        # 输出子页面标题
        10 = TEXT
        10 {
            field = title
            wrap = <h2 class="subpage-title"> | </h2>
        }

        # 输出子页面的tt_content内容
        20 = CONTENT
        20 {
            table = tt_content
            select {
                pidInList.field = uid # 这里的uid是当前遍历的子页面ID
                orderBy = sorting
                where = hidden = 0 AND deleted = 0 # 过滤有效内容元素
            }
            # 给内容加个容器样式，方便排版
            stdWrap.wrap = <div class="subpage-content"> | </div>
        }
    }
}

2. 逐步排查验证 #

• 先测试页面查询是否生效：暂时注释掉renderObj里的20（tt_content部分），只保留10输出标题。如果页面标题能正常显示，说明pages的select查询没问题；如果还是没输出，那要检查：
  • pidInList.field = uid是否能获取到当前归档页面的UID：可以临时换成固定PID（比如pidInList = 123，123是你归档页面的实际UID），如果固定PID能输出标题，说明上下文没有正确传递当前页面的uid（比如你的TS是在某个内容元素里，需要调整获取uid的方式）。
  • 确认归档页面下确实有已发布的子页面（doktype=1，未隐藏、未删除）。
• 再测试tt_content查询：当标题能正常输出后，取消注释20部分，检查子页面的内容是否显示。如果还是没内容，确认子页面下是否有已发布的tt_content元素。

3. 调试技巧 #

• 开启TS调试：在TYPO3后端的「模板」模块中，进入「信息/修改」→「TypoScript对象浏览器」，找到你定义的archiveSubpages对象，查看解析后的结构是否正确。
• 启用查询调试：在select里添加debug = 1，这样会在前端页面输出实际执行的SQL语句，方便确认是否查询到数据：

select {
    # ... 其他配置 ...
    debug = 1
}

按照这个思路调整后，应该就能正常渲染子页面的内容了。

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