TYPO3 V9：如何配置站点实现绝对路径（兼容旧版config.absRefPrefix）

我刚好处理过类似的TYPO3 v9迁移问题，你遇到的情况是因为v9引入的站点管理系统改变了链接生成的逻辑——旧版本直接通过config.absRefPrefix强制所有链接为绝对路径，但v9默认会根据站点Base URL和路由规则生成相对路径，仅TypoScript直接生成的元素（比如页头页脚）会继承absRefPrefix配置。要复现旧版本的全绝对链接效果，需要结合站点配置和TypoScript调整，具体步骤如下：

1. 确认站点Base URL配置 #

首先进入TYPO3后台的站点管理（Site Management），编辑你的目标站点：

• 将「Base URL」设置为完整的绝对路径：https://www.example.com/（必须包含协议、域名，结尾带斜杠）
• 确保站点配置文件（config/sites/{你的站点标识}/config.yaml）中的base字段和上述URL一致，比如：

  base: 'https://www.example.com/'
  routes: {  }
  

2. 调整TypoScript强制全绝对链接 #

保留你原有的config.absRefPrefix配置，同时添加强制链接生成绝对路径的规则：

# 保留原有的absRefPrefix配置
config.absRefPrefix = https://www.example.com/
# 同步设置baseURL确保一致性
config.baseURL = https://www.example.com/

# 强制所有TypoScript生成的链接为绝对路径
config.typolink.forceAbsoluteUrl = 1

# 针对导航菜单（比如HMENU）单独配置（如果你的导航用了HMENU）
lib.mainMenu.10 = HMENU
lib.mainMenu.10.special = directory
lib.mainMenu.10.special.value = 1
lib.mainMenu.10.1 = TMENU
lib.mainMenu.10.1.NO {
  allWrap = <li>|</li>
  # 强制导航链接生成绝对URL
  stdWrap.typolink.forceAbsoluteUrl = 1
}

# 针对内容元素中的链接（比如文本内容里的<a>标签）
tt_content.text.20.parseFunc.tags.a.typolink.forceAbsoluteUrl = 1

3. Fluid模板的额外调整（如果使用Fluid） #

如果你的导航或内容是用Fluid ViewHelper生成的，需要在f:link.page或f:link.typolink中添加absolute="true"属性，比如：

<!-- 导航链接示例 -->
<f:link.page pageUid="{page.uid}" absolute="true" class="nav-link">
  {page.title}
</f:link.page>

<!-- 内容区链接示例 -->
<f:link.typolink parameter="{link}" absolute="true">
  {linkText}
</f:link.typolink>

原理说明 #

TYPO3 v9+的站点管理系统会优先使用站点Base URL生成相对路径，而forceAbsoluteUrl = 1会强制typolink（包括内容元素、导航菜单的链接生成逻辑）忽略相对路径规则，直接生成带完整域名的绝对链接，和旧版本config.absRefPrefix的行为完全一致。

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