如何解决Typo3 12.4.9后端503错误及前后端访问异常

1. 先搞定站点配置与路由 #

• 直接查数据库sys_site表：
  • 核对domainName是不是当前访问的域名（别带http/https，就写xxx.com）
  • base字段必须是完整的URL前缀，比如https://xxx.com/
  • 要是域名从本地改到服务器了，直接跑SQL更新：

    UPDATE sys_site SET domainName='你的实际域名', base='https://你的实际域名/' WHERE uid=1;
    

• 清缓存：
  • 能进命令行就跑vendor/bin/typo3 cache:flush
  • 不行就手动删var/cache下所有文件（别删目录）

2. 检查.htaccess与URL重写 #

• 确保public目录的.htaccess是TYPO3 12.4的标准版本，重点看：
  • 有没有开RewriteEngine On
  • RewriteBase /是不是正确（站点在子目录的话改成/子目录名/）
  • 必须有TYPO3路由规则：

    RewriteRule ^(typo3/|typo3$|index\.php|robots\.txt|favicon\.ico) - [L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule .* index.php [L]
    

• 确认服务器开了URL重写：Apache要开mod_rewrite，Nginx要配置try_files $uri $uri/ /index.php$is_args$args;

3. 后端登录跳转404与/install.php 503的处理 #

• 删var/lock下的install.lock文件，这个文件会锁死安装页面
• 核对settings.php：
  • 检查$GLOBALS['TYPO3_CONF_VARS']['BE']['lockRootPath']指向的目录有没有写权限
  • 数据库配置没问题的话，跑vendor/bin/typo3 database:updateschema同步表结构
• 权限必须给够：
  • Web服务器用户（比如www-data、apache）要能读写var/和public/typo3temp/，执行：

    chown -R www-data:www-data var/ public/typo3temp/
    chmod -R 755 var/ public/typo3temp/
    

4. 前端「未找到站点配置」收尾 #

• 要是能登录后端了，进「站点管理」编辑站点，重新保存一遍，自动生成正确的路由配置
• 实在登不上，手动建站点配置文件：
  • 在config/sites/下建个和域名同名的目录（比如xxx.com/），里面放config.yaml：

    base: 'https://你的域名/'
    baseVariants: {  }
    errorHandling:
      - errorCode: 404
        errorHandler: Page
        errorContentSource: 't3://page?uid=404'
    languages:
      - title: 中文
        enabled: true
        languageId: 0
        base: '/'
        typo3Language: default
        locale: zh_CN.UTF-8
        iso-639-1: zh
        navigationTitle: ''
        hreflang: zh-CN
        direction: ''
        flag: cn
    rootPageId: 1
    routes: {  }
    

  • 记得替换base、rootPageId（你的根页面UID）和语言配置

5. 503错误的深层排查 #

• 看服务器错误日志（Apache的error.log或Nginx的error.log），找具体报错：
  • 大概率是缺PHP扩展（TYPO3 12.4需要ext-json、ext-intl、ext-gd这些）
  • 或者Composer依赖没装全，重新跑composer install --no-dev

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