如何排查并解决Typo3 503错误？迁移项目后页面报错求助

可能原因及对应修复方法 #

1. 维护模式未关闭 #

迁移过程中TYPO3可能自动开启维护模式，导致后台返回503：

• 打开typo3conf/LocalConfiguration.php，找到$GLOBALS['TYPO3_CONF_VARS']['BE']['adminOnly']，将值改为false；
• 若能访问命令行，执行./vendor/bin/typo3 maintenance:disable直接关闭维护模式。

2. Web服务器路由配置失效（前台显示默认PHP页） #

默认PHP页说明请求未转发到TYPO3的index.php入口：

• 检查public目录下的.htaccess文件是否存在且完整，若缺失，从对应版本的TYPO3官方包中复制一份到该目录；
• 确认WAMP的mod_rewrite模块已启用：打开WAMP管理器，进入Apache -> Apache Modules，勾选rewrite_module后重启Apache；
• 检查LocalConfiguration.php中$GLOBALS['TYPO3_CONF_VARS']['FE']['pageNotFound_handling']配置，确保指向TYPO3的入口逻辑。

3. 数据库连接仍存在问题 #

即使修改了凭据，仍可能有其他数据库相关问题：

• 确认目标机器的MySQL中已创建对应数据库，且原项目的数据库数据已完整导入；
• 核对LocalConfiguration.php中$GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default']的dbname、user、password、host（WAMP默认localhost或127.0.0.1）是否完全正确；
• 执行./vendor/bin/typo3 database:updateschema，检查并修复数据库结构不一致问题。

4. Composer依赖未正确安装 #

迁移后依赖包可能缺失或版本不兼容：

• 进入项目根目录，执行composer install（不要用update，避免版本变更），确保所有依赖正确安装；
• 检查Composer执行时的报错信息，确认PHP版本（WAMP的PHP版本需与原项目要求一致）、扩展依赖是否满足要求。

5. 文件权限异常 #

WAMP环境下权限设置可能导致TYPO3无法读写必要文件：

• 确保var（含cache、logs、session子目录）、typo3conf、public/typo3temp目录具备读写权限（Windows下可直接给这些目录添加读写权限）。

6. 站点配置未加载 #

前台显示默认页可能是站点配置未生效：

• 解决503问题后登录后台，进入站点管理，确认站点根页面、入口点配置正确，域名设置为http://localhost/Project/public/；
• 若无法登录后台，检查typo3conf/sites/目录下的站点配置文件，确保base字段设置为本地访问地址。

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