数据库配置失败主因是XAMPP的MySQL服务未正常运行，需检查控制面板状态、端口占用、root密码、错误日志及InnoDB支持；中文包须通过后台语言管理器上传激活；Apache别名需同步配置目录权限。
数据库配置失败：localhost 连不上 MySQL
绝大多数本地部署卡在第一步，不是 Joomla 本身的问题，而是 XAMPP 的 MySQL 服务没真正跑起来。打开 XAMPP Control Panel，确认 MySQL 行右侧是绿色 ✔，不是黄色 ! 或红色 ❌。
常见原因和处理方式：
- 端口被占用（尤其是 3306）：检查是否装了其他 MySQL 实例、Docker、或旧版 WAMP；可在
XAMPP\mysql\conf\my.ini中把port=3306改成port=3307，然后重启 MySQL - root 密码不为空但 Joomla 安装页没填：XAMPP 默认 root 密码为空，但如果之前改过，必须在安装页的「密码」栏填对，否则报错
Access denied for user 'root'@'localhost' - MySQL 启动后立即退出：查看
XAMPP\mysql\data\mysql_error.log，常见是ibdata1损坏，可删掉该文件（先停服务）再重启，XAMPP 会重建
joomla.sql 报错 ENGINE=InnoDB 不支持
安装进度卡在「创建数据库表」，浏览器返回空白或 500 错误，大概率是 MySQL 版本太低（比如 XAMPP 7.4 附带的 MariaDB 10.4+ 默认禁用 InnoDB），而 Joomla 自带的 joomla.sql 强依赖 ENGINE=InnoDB。
临时绕过方法（仅限本地开发）：
- 路径定位：
XAMPP\htdocs\joomla\installation\sql\mysql\joomla.sql - 用记事本或 VS Code 打开，全文搜索
ENGINE=InnoDB，全部替换成ENGINE=MyISAM - 注意大小写敏感：有些版本写的是
engine=innodb，也一并替换 - 替换后保存，刷新安装页重试 —— 此法能跳过建表失败，但后续升级 Joomla 或启用某些扩展可能出兼容问题
中文语言包安装后后台仍是英文
下载的中文包（如 zh-CN.zip）解压后直接丢进 administrator/language/ 或 language/ 目录并不生效。Joomla 要求语言包必须通过后台「语言管理器」激活。
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
正确流程：
- 确保已成功完成 Joomla 安装，并能正常访问
http://localhost/joomla/administrator - 登录后台 → 左侧菜单点「系统」→「语言管理器」→「安装」标签页
- 点击「上传语言包」，选择你下载的
zh-CN.zip文件（不是解压后的文件夹） - 上传成功后，回到「内容」标签页，找到「中文（简体）」，点击右侧「设为默认」
- 关键一步：清空浏览器缓存，或强制刷新（
Ctrl+F5），否则页面仍读取旧的 JS/CSS 缓存，语言不切换
Apache 配置别名后 /joomla 访问 404
有人为了多项目管理，在 httpd.conf 里加了 Alias /joomla "F:/baimos/htdocs/joomla"，结果访问 http://localhost/joomla 报 404，但直接放 htdocs 根目录却能装 —— 这是 Apache 没给该别名目录开启执行权限。
必须同步补上目录权限配置：
- 在
httpd.conf中Alias语句下方，紧跟着添加：
<Directory "F:/baimos/htdocs/joomla">
Require all granted
AllowOverride All
</Directory>
然后重启 Apache。漏掉 AllowOverride All 会导致 Joomla 的 SEO 友好链接（.htaccess 重写）失效，后台设置里「搜索引擎优化」开关就形同虚设。
别名路径中的斜杠方向要统一用正斜杠 /，Windows 下反斜杠 \ 会解析失败；路径末尾不要加斜杠，否则可能触发重定向循环。
