TYPO3 8.0站点URL配置问题：无法实现国别化友好URL

看起来你已经找对了方向，但可能是配置细节或缓存问题导致URL没生效。我来帮你梳理关键步骤和常见坑：

1. 先确认RealURL版本兼容性 #

TYPO3 8.0必须搭配RealURL 2.x系列版本（3.x是给TYPO3 9+准备的）。如果版本不匹配，再正确的配置也没用，先去扩展管理器检查RealURL的版本。

2. 配置RealURL核心规则（realurl_conf.php） #

你需要在typo3conf/realurl_conf.php里明确设置国别路径和站点/语言的映射，分两种场景调整：

场景1：同一站点多语言（DE/AT/CH为不同语言版本） #

如果三个国别是同一站点的多语言分支，用语言ID映射路径：

<?php
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] = [
    '_DEFAULT' => [
        'init' => [
            'enableCHashCache' => true,
            'appendMissingSlash' => 'ifNotFile',
            'enableUrlDecodeCache' => true,
            'enableUrlEncodeCache' => true,
        ],
        'pagePath' => [
            'rootpage_id' => 1, // 你的主根页面ID
            'type' => 'user',
            'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
            'spaceCharacter' => '-',
            'languageGetVar' => 'L',
        ],
        // 核心：语言路径与ID映射
        'preVars' => [
            [
                'GETvar' => 'L',
                'valueMap' => [
                    'de' => '0', // DE对应的后台语言ID
                    'at' => '1', // AT对应的后台语言ID
                    'ch' => '2', // CH对应的后台语言ID
                ],
                'noMatch' => 'bypass', // 无语言前缀时用默认语言
            ],
        ],
    ],
];
?>

场景2：独立多站点（每个国别是单独页面树） #

如果三个国别是完全独立的站点（各有自己的根页面），添加路径到根页面的映射：

<?php
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] = [
    '_DEFAULT' => [
        'init' => [
            'enableCHashCache' => true,
            'appendMissingSlash' => 'ifNotFile',
            'enableUrlDecodeCache' => true,
            'enableUrlEncodeCache' => true,
        ],
        'pagePath' => [
            'type' => 'user',
            'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
            'spaceCharacter' => '-',
        ],
        // 映射路径到对应根页面
        'domainPath' => [
            'hero-pet.de/de/' => ['rootpage_id' => 1], // DE站点根页面ID
            'hero-pet.de/at/' => ['rootpage_id' => 10], // AT站点根页面ID
            'hero-pet.de/ch/' => ['rootpage_id' => 20], // CH站点根页面ID
        ],
    ],
];
?>

3. 调整.htaccess配置 #

确保你的.htaccess有正确的Rewrite规则，且不与RealURL冲突：

RewriteEngine On
RewriteBase /

# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 把所有请求转发到index.php（RealURL负责解析）
RewriteRule ^(.*)$ index.php [L]

另外要确认Apache已启用mod_rewrite，且站点目录的AllowOverride设置为All（否则.htaccess不会生效）。

4. 清除缓存！这是最容易忽略的一步 #

• 登录TYPO3后台，点击Flush all caches（包括页面缓存、配置缓存）
• 额外清除RealURL缓存：可以在RealURL扩展模块里找到「Clear RealURL cache」选项，或者直接删除typo3temp/realurl目录下的所有文件。

5. 后台站点/语言配置检查 #

• 多语言场景：确保后台语言管理里的语言ID和RealURL配置的valueMap完全一致，且根页面的「语言」属性设置正确。
• 多站点场景：每个根页面的「Domain」字段无需填写完整域名，只需保证根页面ID与RealURL的domainPath映射对应，且各站点内容树独立。

常见排查点 #

• 查看RealURL日志：开启debug模式（在RealURL配置里加'debug' => true），查看typo3temp/logs/realurl.log是否有语法错误或解析异常。
• 先测试基础友好URL：先确保单个页面能生成如http://hero-pet.de/start的友好URL，确认RealURL正常工作后再添加国别前缀。
• 检查config.absRefPrefix：在TYPO3模板Setup里，确保config.absRefPrefix = /（不要设置成index.php）。

按这些步骤操作，应该就能搞定国别化友好URL的问题了！

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