在XAMPP/WAMP中通过Apache访问PHP文件夹遇数据库连接错误

检查数据库连接配置 #

• 定位网站代码中的数据库配置文件（常见命名：config.php、db.php），核对核心参数：
  • host：本地环境必须设为localhost或127.0.0.1，禁止使用远程IP/域名
  • port：默认MySQL端口为3306，若手动修改过端口需同步更新
  • username/password：需与PhpMyAdmin登录账号完全一致，注意拼写、大小写
• 排查配置文件中是否存在多余空格、语法错误（比如引号不闭合）

验证MySQL服务状态 #

• 在WAMP/XAMPP控制面板中确认MySQL服务处于Running状态，未启动则手动启动
• 尝试重启MySQL服务，部分异常状态下重启可恢复连接能力

测试基础数据库连接 #

• 新建test_db.php文件，写入以下代码快速验证连接：

<?php
$servername = "localhost";
$username = "你的数据库用户名";
$password = "你的数据库密码";

$conn = new mysqli($servername, $username, $password);
if ($conn->connect_error) {
  die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
$conn->close();
?>

• 访问该文件：若连接成功，问题出在网站业务代码或数据库权限；若仍报错，继续排查底层问题

核对数据库权限 #

• 登录PhpMyAdmin，进入目标数据库，检查对应用户是否拥有该库的访问权限
• 测试环境可临时给用户赋予ALL PRIVILEGES权限，排除权限不足导致的连接失败

排查端口与防火墙 #

• 用命令行检查3306端口占用情况（Windows：netstat -ano | findstr :3306），若被其他程序占用，关闭占用程序或修改MySQL端口
• 确认本地防火墙未拦截3306端口，必要时添加MySQL端口例外规则

验证数据库导入完整性 #

• 重新查看SQL文件导入日志，确认无报错、无中断
• 在PhpMyAdmin中检查数据库表结构、数据是否完整，避免因导入不完整导致的连接异常

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