迁移TYPO3 11.5至新服务器时出现503错误如何解决？

一、503错误额外排查步骤 #

• 查看Apache错误日志（路径一般是/var/log/apache2/error.log），直接定位具体报错信息——503大多和权限、依赖缺失或配置语法错误有关
• 修正文件权限：TYPO3的typo3temp/、fileadmin/、var/目录需要Apache运行用户（通常是www-data）拥有读写权限，执行命令：

  chown -R www-data:www-data /path/to/your/typo3/site
  chmod -R 755 /path/to/your/typo3/site
  chmod -R 775 typo3temp/ fileadmin/ var/
  

• 检查PHP扩展完整性：TYPO3 v11.5必须依赖mysqli、gd、intl、mbstring、zip等扩展，用php -m查看是否缺失，缺失的话通过apt install php7.4-[扩展名称]安装
• 验证LocalConfiguration.php语法：用php -l LocalConfiguration.php检查是否有语法错误（比如引号未闭合、数组格式错误），这是很容易忽略的点
• 确认MySQL用户权限：给配置的数据库用户分配目标数据库的全部权限，执行SQL：

  GRANT ALL PRIVILEGES ON your_typo3_db.* TO 'your_db_user'@'localhost';
  FLUSH PRIVILEGES;
  

• 用命令行强制清缓存：如果能访问站点目录的命令行，执行：

  ./typo3cms cache:flush --force
  

• 检查站点base配置：除了后端设置，确认LocalConfiguration.php里的site段配置正确，或者用命令行更新：

  ./typo3cms site:update your-site-identifier
  

二、更优迁移方案 #

不建议全新安装后逐个插入内容，效率低且容易遗漏配置、权限、扩展设置等关键数据。推荐两种可靠方案：

方案1：官方命令行导出导入 #

1. 原服务器执行站点导出（包含数据库和文件）：

   ./typo3cms site:export your-site-identifier --include-database --include-files
   

2. 将导出的压缩包传到新服务器，解压到站点目录
3. 配置好环境后执行导入：

   ./typo3cms site:import your-site-export-file.zip
   

4. 最后更新base路径和数据库配置，刷新缓存即可

方案2：优化版文件+数据库迁移 #

1. 原服务器先清缓存再打包文件，避免打包无用缓存：

   ./typo3cms cache:flush --force
   zip -r typo3_files.zip /path/to/your/typo3/site -x "*/typo3temp/*" "*/var/cache/*"
   

2. 导出数据库时保证数据一致性：

   mysqldump -u db_user -p --single-transaction your_typo3_db > typo3_db.sql
   

3. 新服务器导入数据库后，用命令行批量更新配置：

   ./typo3cms configuration:set DB.host localhost
   ./typo3cms configuration:set DB.username your_db_user
   ./typo3cms configuration:set DB.password your_db_pass
   ./typo3cms configuration:set DB.database your_typo3_db
   ./typo3cms site:update your-site-identifier
   

4. 最后设置文件权限，刷新缓存即可

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