TYPO3 News Extension分页功能失效技术求助

安全阿岳

2026-5-26

解决TYPO3 News扩展分页不生效的问题

我之前也踩过TYPO3 News扩展的这个分页坑——点击分页链接参数显示正常，但页面内容始终停留在第一页，给你几个实际排查和解决的方向：

优先检查缓存设置
TYPO3的页面缓存是这类问题的高发原因。你可以先把新闻插件的缓存选项设置为不缓存（在插件编辑界面的「缓存」标签里），或者通过Typoscript配置让缓存识别分页参数：
```
plugin.tx_news {
  settings {
    list {
      paginate {
        useCacheHash = 1
      }
    }
  }
}
```
开启useCacheHash后，TYPO3会根据分页参数生成不同的缓存版本，避免所有分页页面共用同一缓存内容。
验证插件的记录存储页配置
确保新闻插件的「记录存储页」包含了所有新闻条目所在的页面ID。如果只选了单个页面，但新闻分布在多个子页面里，分页逻辑会因为找不到后续内容而一直显示第一页。

检查路由增强器（Route Enhancer）配置
如果你用了TYPO3的站点路由增强功能，要确保News的路由规则包含分页widget的参数。比如在站点配置的routeEnhancers里补充：

routeEnhancers:
  News:
    type: Extbase
    extension: News
    plugin: Pi1
    routes:
      - routePath: '/page/{page}'
        _controller: 'News::list'
        _arguments:
          page: '@widget_0/currentPage'
    defaultController: 'News::list'
    defaults:
      page: '1'
    requirements:
      page: '\d+'

这样分页参数会被路由规则正确解析，不会被忽略。

排查Typoscript的分页配置
检查有没有自定义Typoscript覆盖了News的分页默认设置，比如：
```
plugin.tx_news.settings.list.paginate {
  itemsPerPage = 10
  maximumNumberOfLinks = 5
}
```
确认itemsPerPage的值小于总新闻数量（否则分页不会触发），同时确保没有其他配置强制固定了currentPage参数。
尝试升级News扩展版本
某些旧版本的News扩展存在分页widget的参数传递bug，升级到最新稳定版大概率能解决这类遗留问题。