TYPO3 10.4.12 迁移至服务器后带www访问显示空白页如何解决
TYPO3 10.4.12 带www域名访问空白、裸域正常的配置方案
问题核心原因
TYPO3 10.4的前端请求路由完全依赖内置的**站点配置(Site Configuration)**的域名匹配规则,不依赖默认htaccess做站点识别。部署完成后通过裸域(不带www的域名)第一次访问站点时,系统会自动把裸域登记为该站点唯一的匹配基准域名;当接收到带www的同域名请求时,系统找不到匹配的站点配置条目,就会直接返回空响应,表现为访问空白页,这也是服务商判断问题出在TYPO3自身设置的依据。
具体配置操作
- 登录TYPO3后台,进入左侧导航栏的*站点管理(Sites)*模块,选中当前部署的目标站点
- 切换到「语言与域名(Languages and Domains)」标签页,此时列表里仅能看到不带www的裸域条目,没有对应www域名的记录
- 点击「添加新域名」按钮,按实际需求填写参数:
- 域名字段填写完整的带www域名,如
www.yourdomain.com - 关联语言选择和现有裸域完全一致的默认站点语言
- 默认域名标记规则:如果要保留裸域为主访问入口,保持原有裸域的「该语言默认基准域名」勾选状态不变,新增的www域名不勾选即可;如果要统一跳转www域名,就取消原有裸域的默认标记,勾选新增www条目的默认选项
- 域名字段填写完整的带www域名,如
- 保存站点配置,系统会自动将规则写入站点目录下的
config.yaml文件,无需手动编辑代码
易遗漏的排查项
- 配置完成后如果仍然空白,先清理TYPO3全局路由缓存:删除
var/cache/目录下的所有文件,避免旧的路由匹配规则缓存没有刷新 - 检查可信主机配置:在后台「设置 -> 配置分析」中找到
[SYS][trustedHostsPattern]项,10.4版本会自动校验请求头的Host值是否匹配规则,如果规则只写了裸域的正则表达式,带www的请求会被系统直接拦截返回空白,调整规则为可同时匹配两个域名的正则(如^(yourdomain\.com|www\.yourdomain\.com)$)即可 - 排除服务器层面的路径问题:在站点根目录放一个测试用的空PHP文件,分别用两个域名访问该测试文件,确认两个域名都指向了同一个站点根目录,不存在www域名绑定到空目录的情况
- 如需统一域名跳转(比如所有www请求301重定向到裸域,或反向跳转),无需手动修改htaccess规则,直接在站点配置的域名编辑页设置「Redirect to」目标地址即可,系统会自动生成可靠的301跳转规则,避免手动写规则和TYPO3路由冲突
内容的提问来源于stack exchange,提问作者Tim Döring
相关产品推荐
相关产品推荐

