Bitnami for XAMPP安装前必须确认：1. XAMPP中Apache与MySQL均显示绿色“Running”状态；2. 安装路径不含中文、空格或特殊符号；3. Bitnami安装程序以管理员身份运行。
Bitnami for XAMPP 安装前必须确认的三件事
Bitnami 模块不是独立运行环境，它必须依附于已安装且可启动的 XAMPP —— 如果 Apache 和 MySQL 在控制面板里显示红色“Stopped”，Bitnami 安装会直接失败或后续无法访问站点。
常见错误现象：Installation failed: Cannot connect to MySQL server 或安装完成后浏览器打不开 http://localhost；本质是 Bitnami 脚本在初始化阶段尝试连接 localhost:3306 失败。
- 确保 XAMPP 控制面板中
Apache和MySQL均为绿色 “Running” 状态（首次启动可能需几秒） - 安装路径不能含中文、空格或特殊符号（例如
D:\XAMPP✅，C:\Program Files\xampp❌） - Bitnami 安装程序必须以管理员身份运行，否则写入
htdocs或修改配置文件时会被 Windows UAC 拦截
下载与选择对应版本的 Bitnami 模块
Bitnami 提供的 Drupal、WordPress、Joomla 等模块，每个都绑定特定 PHP/MySQL 版本。若你用的是 XAMPP 8.2.12（含 PHP 8.2），却下载了标着 “for PHP 7.4” 的 WordPress 模块，安装过程可能卡在依赖检查，或安装后页面报 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。
正确做法是：访问 https://bitnami.com/stacks → 点击目标应用（如 WordPress）→ 查看右侧 “Compatible with” 栏目 → 匹配你本地 XAMPP 的 PHP 主版本号（如 8.2.x）→ 下载带 “Windows Installer” 后缀、且明确标注 “XAMPP” 的安装包（例如 wordpress-6.5.3-0-xampp-windows-x64-installer.exe）。
- 不要下载 “Virtual Machine” 或 “Cloud Image” 类型，它们不适用于 XAMPP 集成
- 避免使用旧版 Bitnami（如 2019 年前发布的 Drupal 7 模块），其默认调用已被废弃的
mysql_*()函数 - 安装包名中含
xampp字样才是正解；不含的（如wordpress-6.5.3-0-installer.exe）是独立堆栈，会另起一套服务，与你的 XAMPP 冲突
安装过程中最关键的两步操作
Bitnami 安装向导看似傻瓜式，但有两处用户极易跳过或填错，直接导致后台无法登录或数据库连接失败。
第一步：在 “Select XAMPP Installation Directory” 页面，必须手动点击 Browse，精准定位到你的 XAMPP 根目录（如 D:\XAMPP），而不是让它默认填 C:\xampp —— 即使你没装在 C 盘，它也常预设错误路径。
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
第二步：在 “Database Configuration” 页面，Database User 默认是 root，Password 默认为空（XAMPP 默认无 root 密码），但如果你之前用 phpMyAdmin 改过 MySQL root 密码，这里必须填**真实密码**，否则安装脚本无法创建新数据库，后续所有页面都会提示 Error establishing a database connection。
- 网站管理员账号（如 WordPress 的
admin用户）和密码在此步设定，务必记牢 —— Bitnami 不提供找回入口 - “SMTP Configuration” 可全选跳过（保持默认 “No”），否则它会要求填邮箱服务器参数，新手极易卡住
- 安装完成页勾选 “Launch application in browser” 是有用的，它会自动打开
http://localhost/wordpress，验证是否真跑起来了
安装后访问不到页面？先查这三个位置
Bitnami 安装成功 ≠ 网站能访问。最常被忽略的是 Apache 的虚拟主机配置未生效，或端口被占，或 Windows 防火墙拦截。
第一，打开 XAMPP 控制面板 → 点击 Apache 行的 Config → 选 httpd-vhosts.conf → 确认末尾是否新增了类似这样的段落：
Alias /wordpress "D:/XAMPP/apps/wordpress/htdocs/"
<Directory "D:/XAMPP/apps/wordpress/htdocs">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
没有？说明 Bitnami 未成功写入配置，需手动添加并重启 Apache。
- 第二，检查
httpd.conf中Include conf/extra/httpd-vhosts.conf这行是否被注释（开头有#），如果是，删掉#并重启 - 第三，如果访问
http://localhost/wordpress显示 403 Forbidden，大概率是Require all granted缺失，或目录权限继承异常 —— 此时直接改用http://localhost访问 XAMPP 默认页，再点顶部导航栏的 “Applications” 列表，从那里进更稳妥 - 第四，某些杀毒软件（如 360、腾讯电脑管家）会在安装后自动拦截
httpd.exe网络行为，需进其设置里放行 Apache 进程
Bitnami 模块把应用文件放在 XAMPP\apps\<appname>\htdocs\</appname>，而非传统 htdocs\<appname></appname> —— 这个路径结构决定了它必须靠 Alias 或虚拟主机才能被 Apache 识别，跳过配置就等于白装。
