TYPO3迁移至新机器后MySQL数据库不可用，TYPO3无响应

嘿，第一次搞TYPO3迁移遇到问题太正常了，别慌！我帮你一步步排查可能的原因：

1. 先搞定文件权限和所有者问题 #

TYPO3对文件权限要求特别严格，尤其是几个核心目录：

• 确认新服务器上var/、typo3temp/、fileadmin/这些目录的所有者和Web服务器用户一致（通常是www-data、apache或者nginx，取决于你的服务器环境）
• 执行命令快速修复权限（替换成你的实际站点路径）：

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

2. 核对数据库连接配置 #

TYPO3的数据库配置在typo3conf/LocalConfiguration.php里，一定要确保参数和新服务器完全匹配：

• 检查DB节点下的host、dbname、user、password是否正确，本地数据库通常用localhost或127.0.0.1，别沿用旧服务器的地址
• 可以手动测试数据库连接，验证账号密码是否有效：

  mysql -u your_db_user -p -h your_db_host your_db_name
  

  能成功登录的话，说明数据库本身的连接没问题。

3. 清空缓存+修正站点URL配置 #

迁移后旧缓存是重灾区，先清理掉：

• 删除var/cache/和typo3temp/下的所有文件（别删目录本身）
• 检查LocalConfiguration.php里的site配置，base URL要和新服务器的域名/临时IP匹配，比如临时用IP访问的话，要改成http://your-new-server-ip/
• 如果是全新安装后替换数据库，记得把旧站点的typo3conf/目录（包含LocalConfiguration.php和AdditionalConfiguration.php）替换过去，别用新安装的默认配置文件

4. 查日志找具体错误线索 #

如果以上操作都没用，就得看日志定位问题：

• Web服务器日志：Apache的error.log或Nginx的error.log，通常在/var/log/apache2/或/var/log/nginx/目录下，找PHP报错或TYPO3相关的异常信息
• TYPO3自身日志：var/log/目录下的typo3_*.log，这里会记录运行时的详细错误，比如数据库查询失败、文件缺失等

5. 验证PHP版本和扩展兼容性 #

• 确认新服务器的PHP版本和旧服务器一致，TYPO3不同版本对PHP版本要求很严，比如TYPO3 11需要PHP 7.4-8.1，TYPO3 12需要PHP 8.1-8.2
• 检查PHP扩展是否齐全：必须的扩展有mysqli/pdo_mysql、gd、json、zip、intl等，用php -m命令查看已安装扩展，对比旧服务器的列表

内容的提问来源于stack exchange，提问作者Seb.Lae