TYPO3 11升级后config.absRefPrefix失效，如何让f:link.typolink生成带域名链接？

问题原因 #

TYPO3 10+版本引入了Site Handling站点配置机制，替代了旧版realurl的部分功能，同时调整了config.absRefPrefix的作用范围：

• 该配置现在仅用于**静态资源（图片、CSS/JS等）**的路径补全，这也是你的图片链接仍能正常带上主域名的原因。
• 页面链接的生成逻辑完全由Site Handling中的站点Base URL控制，f:link.typolink会优先使用站点配置的base URL生成链接，而非absRefPrefix。如果主站Site配置未正确设置Base URL，或者路由系统判定链接为站内相对路径，就会生成以/开头的相对链接。

解决方案 #

1. 配置Site Handling的主站Base URL（推荐） #

进入TYPO3后台的Site Management：

• 编辑主站的站点配置，将Base URL设置为https://www.maindomain.tld/，确保勾选Is site选项。
• 保存后，路由系统会自动使用该base URL生成所有页面链接，f:link.typolink生成的菜单链接会自动带上主域名。

2. 强制f:link.typolink生成绝对链接 #

在Fluid模板中，为f:link.typolink添加absolute="true"属性，强制生成包含主域名的绝对链接：

<f:link.typolink parameter="{yourPageId}" absolute="true">链接文本</f:link.typolink>

如果是从renderType = inputLink的字段读取链接值，同样可以在模板中添加该属性：

<f:link.typolink parameter="{yourLinkField}" absolute="true">链接文本</f:link.typolink>

3. 补充TypoScript配置强化绝对链接生成 #

如果需要全局控制页面链接的绝对化，可以在主站的TypoScript模板中添加以下配置：

# 设置主站基础URL
config.baseURL = https://www.maindomain.tld/
# 强制所有链接生成绝对URL
config.absRefPrefix = https://www.maindomain.tld/
config.linkVars = L
# 确保查询参数被正确附加
config.addQueryString = 1

注意：该配置需配合正确的Site Handling设置才能生效。

为什么图片链接不受影响？ #

TYPO3 11中，静态资源（图片、媒体文件）的路径生成逻辑仍依赖config.absRefPrefix，因此你的图片链接会自动带上主域名，与页面链接的生成逻辑区分开。

内容的提问来源于stack exchange，提问作者Bernd Wilke πφ