xampp 中 mysql 恢复后 wordpress 仍报“error establishing a database connection”，通常并非单纯服务未启动，而是数据库配置、权限、文件一致性或表结构引用异常所致，需系统性验证 wp-config.php、mysql 状态、数据目录完整性及关键表内容。
xampp 中 mysql 恢复后 wordpress 仍报“error establishing a database connection”，通常并非单纯服务未启动，而是数据库配置、权限、文件一致性或表结构引用异常所致，需系统性验证 wp-config.php、mysql 状态、数据目录完整性及关键表内容。
当你通过替换 xampp/mysql/data/ 目录（如重命名旧目录为 Data_old 并重建新 Data 文件夹）成功启动 MySQL 服务后，WordPress 却提示 “Error establishing a database connection”，这表明 MySQL 进程虽在运行，但 WordPress 无法有效访问其数据库——问题已从服务层面下沉至连接配置、用户权限或数据库元数据一致性层面。
✅ 第一步：确认基础连接参数无误
检查 WordPress 根目录下的 wp-config.php，确保以下四行与当前 MySQL 实际环境完全匹配：
define('DB_NAME', 'your_database_name'); // 数据库名（必须已存在）
define('DB_USER', 'root'); // 默认用户名（XAMPP 为 root）
define('DB_PASSWORD', ''); // XAMPP 默认密码为空字符串（非 'root'！）
define('DB_HOST', 'localhost:3306'); // 端口务必明确（若修改过端口需同步）⚠️ 常见错误：
- DB_PASSWORD 被误设为 'root'（XAMPP 默认无密码）；
- DB_HOST 写成 '127.0.0.1' 而非 'localhost'（在 Windows 下二者行为可能不同，尤其涉及 socket 连接时）；
- 数据库名拼写错误，或该数据库根本未被导入/重建。
✅ 第二步：验证数据库与用户权限是否就绪
仅启动 MySQL 服务不等于 WordPress 所需数据库已就位。请执行以下操作：
- 访问 http://localhost/phpmyadmin；
- 登录（默认用户 root，空密码）；
- 检查左侧数据库列表中是否存在 wp-config.php 中指定的 DB_NAME；
- 若不存在 → 需手动创建同名数据库（排序规则建议选 utf8mb4_unicode_ci）；
- 点击该数据库 → 查看“用户账户”标签页 → 确认 DB_USER（如 root）对该库拥有 SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, INDEX 等必要权限。
? 提示：若你曾从 Data_old 中恢复 .ibd 或 .frm 文件但未完整迁移系统表（如 mysql.user），可能导致用户权限丢失。此时可运行 mysql_upgrade（XAMPP 控制面板 → Shell → 输入 mysql_upgrade -u root --password=）重建权限表。
✅ 第三步：检查关键数据表完整性（尤其是 wp_options 和 wp_posts）
正如答案中提示，某些场景下数据库虽可连接，但核心表（如 wp_options 中的 siteurl/home）或 wp_posts 中的 guid、post_name 字段若残留旧路径（如 http://old-local.dev）、损坏或编码异常，会导致 WordPress 在初始化阶段因无法解析站点信息而中断连接流程。
使用 phpMyAdmin 执行快速校验：
生产级WordPress REST API集成，用于管理文章、页面、媒体、WooCommerce产品、Elementor内容、SEO元数据、ACF及JetEngine字段
-- 检查 wp_options 表中关键站点配置
SELECT option_name, option_value
FROM wp_options
WHERE option_name IN ('siteurl', 'home');
-- 检查 wp_posts 中首几条文章的 permalinks 是否格式合法（应为相对路径或正确本地域名）
SELECT ID, post_name, guid
FROM wp_posts
WHERE post_status = 'publish'
ORDER BY ID DESC
LIMIT 5;✅ 正常值示例：
- siteurl: http://localhost/your-site
- home: http://localhost/your-site
- guid: http://localhost/your-site/?p=1
- post_name: hello-world（纯字母数字+短横线）
❌ 异常信号：
- guid 含外部域名（如 https://live-site.com/...）；
- post_name 出现乱码、空格或特殊符号；
- 查询返回空结果 → 表可能未正确导入或结构损坏。
✅ 第四步：终极验证 —— 手动建立最小连接测试
在 WordPress 根目录新建 test-db.php，内容如下：
<?php
$host = 'localhost';
$user = 'root';
$pass = '';
$db = 'your_database_name'; // 替换为实际 DB 名
$conn = mysqli_connect($host, $user, $pass, $db);
if (!$conn) {
die("❌ 连接失败: " . mysqli_connect_error());
}
echo "✅ 连接成功！MySQL 版本: " . mysqli_get_server_info($conn);
mysqli_close($conn);
?>访问 http://localhost/your-site/test-db.php：
- 若显示 ✅ → 证明 PHP 可连库，问题出在 WordPress 配置或插件/主题初始化环节；
- 若显示 ❌ → 错误信息将精准指向原因（如 Access denied = 权限问题，Unknown database = 库名错误）。
? 总结与建议
该问题本质是数据目录“硬恢复”引发的配置断层：替换 data/ 目录绕过了 MySQL 的正常启停流程，易导致权限表、字符集设置、InnoDB 元数据与物理文件不一致。推荐后续操作：
- 优先使用 mysqldump 备份 + mysql 命令还原数据库，而非直接拷贝 data/ 文件夹；
- 升级 XAMPP 至最新版（含 MySQL 8.0+），启用 innodb_file_per_table=ON 降低恢复风险；
- 在 wp-config.php 末尾添加 define('WP_ALLOW_REPAIR', true);，访问 http://localhost/your-site/wp-admin/maint/repair.php 自动修复表结构。
完成上述任一环节修正后，务必清除浏览器缓存并重启 XAMPP（Apache + MySQL），再访问 WordPress 站点。
