Joomla 3.10迁移新MariaDB后端后重命名旧库遇会话启动错误

1. 检查Joomla会话存储配置 #

• 查看站点根目录下的configuration.php文件，定位session_handler参数：
  • 如果参数值为database，确认文件中对应的数据库连接配置（host、user、db）是否全部指向新Docker MariaDB，排查是否存在硬编码旧数据库名称的情况。
  • 如果参数值为native，说明会话基于文件存储，需结合错误提示中的路径进一步排查。
• 恢复旧数据库名称后登录Joomla后台，进入全局配置-系统页面，确认“会话处理程序”设置是否正确；若为数据库存储，检查关联的数据库连接是否指向新库。

2. 排查PHP会话文件的权限与配置 #

• 针对错误提示中的会话存储路径/var/lib/php/sessions：
  • 确认该目录的所有者为Joomla运行的Web服务器用户（如www-data、apache），权限设置为700（确保仅所有者可读写）。
  • 查看PHP配置文件（php.ini或php-fpm专属配置）：
    • 确认session.save_path确实指向/var/lib/php/sessions，无配置路径错误。
    • 确认session.save_handler为files（与Joomla的native会话处理逻辑匹配），未被.htaccess或其他配置文件覆盖。

3. 数据库层面排查隐藏依赖 #

• 登录新Docker MariaDB，执行SQL查询排查核心表中的旧数据库残留信息：
  • 查询会话相关插件的配置：

    SELECT * FROM #__extensions WHERE type='plugin' AND folder='session';
    

    检查结果中的params字段，确认是否包含旧数据库的连接信息。
  • 查询全局配置表：

    SELECT * FROM #__config WHERE value LIKE '%旧数据库名称%';
    

    排查是否有扩展或系统配置硬编码了旧数据库名称。

4. 清理缓存与残留会话数据 #

• 清理Joomla缓存：删除站点根目录下cache/、administrator/cache/文件夹内的所有文件，或通过后台“系统-清除缓存”功能完成操作。
• 清理PHP会话文件：执行命令删除服务器上的残留会话数据：

  rm -rf /var/lib/php/sessions/*
  

5. 检查其他关联进程的DB配置 #

• 排查Joomla定时任务（cron脚本）、CLI工具等辅助进程，确认这些进程的配置文件是否仍指向旧数据库名称，避免引发会话冲突。
• 确认Docker容器网络配置正常，Joomla容器能稳定连接新MariaDB容器，无DNS解析或网络连接异常。

内容的提问来源于stack exchange，提问作者Marcus Flöser