升级TYPO3 10.4至11.5后后台登录报404如何解决？

核心问题定位 #

从报错信息和现象来看，问题根源在于数据库连接配置未正确迁移、后台登录路由/Provider配置异常，以及部分代码依赖的全局变量在11.x版本中被废弃。

1. 修复数据库连接配置 #

TYPO3 11.x重构了数据库连接的配置结构，需确保配置格式符合新版本要求：

• 打开config/system/additional.php或config/system/settings.php（根据你的配置目录结构）
• 确认Default数据库连接的数组配置正确，示例格式：

$GLOBALS['TYPO3_CONF_VARS']['DB']['Connections']['Default'] = [
    'dbname' => '你的数据库名',
    'host' => 'localhost',
    'password' => '你的数据库密码',
    'user' => '你的数据库用户名',
    'driver' => 'mysqli',
    'charset' => 'utf8mb4',
];

• 若之前使用10.x的旧格式（直接在$GLOBALS['TYPO3_CONF_VARS']['DB']下配置），需迁移到上述Connections嵌套结构
• 保存配置后，删除var/cache目录下的所有文件，或通过安装工具（/typo3/install）执行"Clear all cache"

2. 修复后台登录路由及Provider问题 #

登录后跳转到404，多因登录Provider配置或服务器重写规则异常：

• 检查config/system/additional.php中是否存在默认登录Provider的配置，11.x需确保以下配置存在：

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['backend']['loginProviders'][1433416747] = [
    'provider' => \TYPO3\CMS\Backend\LoginProvider\UsernamePasswordLoginProvider::class,
    'sorting' => 100,
    'iconIdentifier' => 'actions-key',
    'label' => 'LLL:EXT:backend/Resources/Private/Language/locallang_login.xlf:login.link'
];

• 验证服务器重写规则：
  • Apache：确保.htaccess中包含TYPO3 11.x默认的重写规则，重点检查这条：

    RewriteRule ^typo3/(.*)$ %{ENV:CWD}index.php?route=/typo3/$1 [L]
    

  • Nginx：配置正确的location规则：

    location /typo3 {
        try_files $uri $uri/ /index.php?$args;
    }
    

• 清除路由缓存：删除var/cache/code/cache_core目录，或通过安装工具执行"Flush backend caches"

3. 解决Console命令的$LANG未定义问题 #

TYPO3 11.x已废弃全局$LANG变量，需替换为官方推荐的依赖注入方式：

• 检查自定义扩展或修改的系统代码，将所有global $LANG的用法替换为\TYPO3\CMS\Core\Localization\LanguageService的依赖注入
• 若为第三方扩展导致，执行composer update确保所有依赖扩展已更新到适配11.x的版本

4. 完成TYPO3全量设置 #

Console提示"TYPO3 is not fully set up"，需完成升级后的必要步骤：

• 访问安装工具（/typo3/install），逐一完成"Upgrade Wizard"中的所有任务（包括数据库结构更新、扩展兼容性检查等）
• 执行命令自动完成升级：

  vendor/bin/typo3cms upgrade:run all
  

• 再次执行vendor/bin/typo3cms，确认错误提示消失

验证步骤 #

1. 尝试登录后台，确认不再跳转到404页面
2. 执行vendor/bin/typo3cms scheduler:run，确认数据库连接错误已修复

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