DVWADamn Vulnerable Web Application是我这类做安全测试练习的人非常熟悉的本地靶场但每次帮朋友排查搭建问题十次里有七八次都卡在同一个环节数据库连不上。页面打开之后不是直接进入登录页而是甩出一段红字报错要么是Connection refused要么是Access denied再要么就是No such file or directory。这篇文章不打算照抄官方安装文档我想把这些年在不同环境下折腾 DVWA 数据库连接问题的完整排查路径、处理办法和踩过的坑一次性写清楚。适合正在照着教程搭建 DVWA、却在数据库这步反复失败的读者也适合那种刚接触 LAMP 或 XAMPP 集成环境、对 PHP 和 MySQL 之间怎么建立连接还不太熟悉的人。很多人以为“无法连接数据库”就是密码填错了但实际排查下来真正的原因往往藏在操作系统服务、PHP 扩展、socket 路径、甚至是配置文件编码这些不起眼的细节里。我写这篇文章的态度是不绕弯子不堆术语先把问题现象分清楚再按可能性从高到低一个个验证最后给出一套可以直接照做的解决流程。你不需要成为数据库专家只要跟着步骤走大多数情况下都能把 DVWA 重新拉起来。1. 问题现象的典型表现先分清你遇到的是哪一类报错1.1 我在搭建过程中实际见到的几类报错DVWA 在安装阶段会引导你访问setup.php来初始化数据库或者你在直接打开首页时就会触发数据库连接。我整理了一下常见的报错文本几乎都可以归为三类报错特征典型提示最可能的原因连接被拒绝SQLSTATE[HY000] [2002] Connection refusedMySQL 服务未启动或端口、地址配置不对访问被拒绝SQLSTATE[HY000] [1045] Access denied for user rootlocalhost账号密码错误或者用户权限不足找不到连接文件SQLSTATE[HY000] [2002] No such file or directoryPHP 走 socket 连接但路径与 MySQL 实际 socket 不一致驱动或扩展缺失The mysqli extension is missing或PDO Driver for MySQL not foundPHP 没启用 mysqli / pdo_mysql 扩展数据库不存在Unknown database dvwa初始化没跑成功数据表没建出来这里面的关键点在于同样是“无法连接数据库”根因可能天差地别。Connection refused是“连不上门”Access denied是“门开了但钥匙不对”No such file or directory则是“你找错门了”。如果你不区分现象直接去改密码大概率白忙活一场。1.2 为什么这些报错都指向数据库连接DVWA 用 PHP 写的它底层通过mysqli或PDO扩展去访问 MySQL/MariaDB。搭建 DVWA 时数据库连接涉及四个关键要素数据库服务地址、端口、账号密码、目标库名。这四个要素缺一不可而且任意一个出错DVWA 都会给出数据库连接类报错。我曾经见过有人把db_server从127.0.0.1改成localhost报错就从Connection refused变成了No such file or directory——这跟 PHP 在两种写法下解析 socket 还是 TCP 有关。搞清楚这个逻辑你就能在后续排查中少走很多弯路。2. 从最基础的一步开始确认 MySQL/MariaDB 服务真的活着2.1 服务状态与端口检查别再凭感觉判断数据库连接失败最常见的单一原因就是数据库服务压根没起来。尤其是用 XAMPP、phpStudy 这类集成环境的人很容易出现控制面板显示 MySQL 绿色、但实际进程已崩溃的情况。我先说 Linux 下的操作方法。如果你用的是系统自带的 MySQL 或 MariaDB可以执行systemctl status mysql # 或者 systemctl status mariadb如果服务没起来先启动它systemctl start mysql systemctl enable mysql接着检查 3306 端口是否处于监听状态netstat -tlnp | grep 3306正常你会看到类似0.0.0.0:3306或127.0.0.1:3306的监听行。如果没有任何输出说明 MySQL 进程没起来或者配置里改了端口、根本没监听外部连接。在 Windows 上如果你用的是 XAMPP可以直接看 XAMPP Control Panel 里 MySQL 行的日志也可以去C:\xampp\mysql\data\目录看错误日志。很多情况下 MySQL 启动失败是因为data目录权限不对或者残留的ibdata1文件损坏。2.2 端口被占用或 socket 路径不一致一个非常隐蔽的坑如果你确认服务已经起来了但依然报Connection refused那就得检查配置里用的端口是不是 3306有没有被其他程序占用。常见的情况是装了多个 MySQL 实例或者之前有残留进程占着 3306导致新启动的 MySQL 选择不监听这个端口。在 Linux 下查看端口占用lsof -i :3306 netstat -tlnp | grep 3306如果看到别的进程占了 3306需要停掉或改端口。DVWA 的配置文件在DVWA/config/config.inc.php里面会定义数据库连接信息$_DVWA[ db_server ] 127.0.0.1; $_DVWA[ db_database ] dvwa; $_DVWA[ db_user ] root; $_DVWA[ db_password ] ; $_DVWA[ db_port ] 3306;注意看db_server。127.0.0.1表示走 TCP 连接而localhost在 PHP 的某些配置下会尝试走 Unix socket。如果你的 MySQL 默认 socket 路径不在 PHP 预期位置就会报No such file or directory。在 XAMPP 环境里常见做法是把db_server明确写成127.0.0.1避开 socket 路径问题。这里多提一句如果你是自己编译安装的 PHP 和 MySQL出现 socket 路径不匹配的概率很高。查看 MySQL 的 socket 路径mysql -u root -p -e SHOW VARIABLES LIKE socket;查看 PHP 默认配置里 mysqli 的 socket 路径php -i | grep mysqli.default_socket如果两者不一致要么修改php.ini里mysqli.default_socket配置要么在 DVWA 配置文件中坚持用 TCP 地址连接后者的效率更高因为你不用改动全局配置。3. 账号密码与权限配置Access denied 背后的真正逻辑3.1 DVWA 配置文件到底在连接什么在集成环境里很多人默认 MySQL 的 root 账号没有密码直接把 DVWA 的db_password留空这是最标准的初始配置。但一旦你给 root 设置了密码而配置文件没同步更新就会立刻出现 1045 的Access denied报错。DVWA 的默认配置是$_DVWA[ db_user ] root; $_DVWA[ db_password ] ;如果你本机 MySQL root 有密码比如123456那就改成$_DVWA[ db_password ] 123456;改完要注意DVWA 配置文件是 PHP 文件修改后不需要重启 Apache但需要清一下浏览器缓存。尤其是如果你用php -S内置服务器跑 DVWA改配置后刷新页面即可生效。3.2 root 账号远程访问限制和用户权限问题除了密码另一个常见的坑是 MySQL 用户权限。DVWA 初始化时需要在dvwa数据库里创建数据表这要求配置文件中指定的用户对dvwa库至少拥有CREATE、INSERT、SELECT、UPDATE、DELETE等权限。如果你用了默认 root权限一般没问题但如果你改成自定义用户很可能因为权限不足导致建表失败。在 MySQL 里给自定义用户授权的命令如下CREATE USER IF NOT EXISTS dvwalocalhost IDENTIFIED BY dvwa123; GRANT ALL PRIVILEGES ON dvwa.* TO dvwalocalhost; FLUSH PRIVILEGES;这里有个细节如果连接时db_server用127.0.0.1MySQL 可能会把用户视为dvwa127.0.0.1而不是dvwalocalhost。为了避免这类问题你可以同时创建两个用户CREATE USER IF NOT EXISTS dvwa127.0.0.1 IDENTIFIED BY dvwa123; GRANT ALL PRIVILEGES ON dvwa.* TO dvwa127.0.0.1; FLUSH PRIVILEGES;我见过一个很奇葩的案例MySQL 里存在多个 root 账号有的rootlocalhost密码为空有的root127.0.0.1密码不为空。DVWA 用127.0.0.1去连走的root127.0.0.1密码校验失败怎么看都像密码写错实际上是被另一条认证规则拦住了。遇到这种玄学问题直接在 MySQL 里查看用户表SELECT user, host, authentication_string FROM mysql.user WHERE user root;你会看到每个账号的 host 范围这能帮你快速定位为什么命令行能登录、但 DVWA 连不上。4. PHP 版本、扩展与连接超时容易被忽略的另一座山4.1 PHP 版本与 mysqli 扩展缺失DVWA 是老牌项目官方需求是 PHP 5.x 到 7.x但实际在 PHP 8 上也能勉强跑起来只是要注意扩展是否齐全。如果你在页面里看到类似The mysqli extension is missing的提示说明 PHP 没有启用mysqli扩展。Linux 下安装扩展# Ubuntu / Debian 系 sudo apt install php-mysql sudo systemctl restart apache2 # CentOS / RHEL 系 sudo yum install php-mysqlnd sudo systemctl restart httpdWindows 的 XAMPP 环境下通常是去C:\xampp\php\php.ini里找到extensionmysqli去掉前面的分号extensionmysqli extensionpdo_mysql保存后重启 Apache。还有一类情况是PHP 启用了扩展但 CLI 和 Apache 模块用的php.ini不是同一个文件导致你在命令行测试正常、页面却依然报错。用phpinfo()输出页面查看Loaded Configuration File和mysqli扩展状态可以确定当前 Web 环境到底加载了哪个配置。4.2 PHP 8 下的兼容性与连接超时问题PHP 8 把很多默认行为改得更严格DVWA 这种老项目会触发一些提醒甚至报错。最常见的就是mysqli_connect()返回false后老代码没有抛出异常但新版 PHP 的mysqli默认开启了异常模式导致页面直接出现Uncaught mysqli_sql_exception。如果你不想深究代码最省事的做法是安装 PHP 7.4 来跑 DVWA。XAMPP 新版可以切换 PHP 版本Linux 下也可以用 Docker 快速起一个 PHP 7.4 的环境。另一种情况是连接超时表现为页面长时间转圈最终报Connection timed out。这与数据库无关往往是防火墙拦截了 3306 端口或者 MySQL 的bind-address设置只允许本地连接。检查一下 MySQL 配置文件[mysqld] bind-address 127.0.0.1如果你需要其他机器访问 DVWA 的数据库就改成0.0.0.0并确保防火墙放行 3306 端口。不过对本地练习来说保持127.0.0.1就够了。5. 终极方案手动建库、导数据、重置配置彻底重来一遍5.1 手动创建数据库与用户绕过 setup.php 的坑DVWA 的安装页面setup.php有时候会因为各种原因卡在“Create Database”这一步尤其是在 PHP 8 环境里或者权限配置不正确时。这时候最粗暴可靠的办法是手动完成数据库初始化。DVWA 自带了数据库初始化 SQL 文件一般在DVWA/sql/create_db.sql。你可以在命令行里执行mysql -u root -p /path/to/DVWA/sql/create_db.sql如果你使用的是 XAMPP且 root 没有密码mysql -u root C:\xampp\htdocs\DVWA\sql\create_db.sql执行完以后你可以登录 MySQL 查一下表是否建立成功USE dvwa; SHOW TABLES;正常情况下会看到users、guestbook等表。如果表已经存在但页面还是说数据库不存在多半是配置文件里db_database写错库名比如写成了dvw或者大小写不一致MySQL 在 Linux 下对库名和表名是区分大小写的。手动导入 SQL 还有一个额外好处你可以顺便确认 DVWA 需要连接的库确实存在而不是在setup.php的页面上干瞪眼。5.2 重置 DVWA 配置文件与典型重装顺序如果你折腾了很久还是搞不定我建议把所有配置重置干净按以下顺序重新来一遍确认 MySQL 服务正常启动root 密码是你已知的。在 MySQL 里手动创建dvwa库导入create_db.sql。检查 PHP 的mysqli和pdo_mysql扩展启用情况。把 DVWA 的config/config.inc.php里的db_server设为127.0.0.1db_port设为3306db_user设为 rootdb_password设为你的实际密码。访问/DVWA/setup.php点击Create / Reset Database看是否提示成功。访问/DVWA/login.php用默认账号admin/password登录。这个顺序是我反复验证过的每一环节的信息都能通过独立步骤确认不像页面一条龙安装那样报错时根本分不清是哪一步出了问题。如果你在第 5 步出现超时或报错优先回到第 2 步确认库表是否存在再看第 4 步的配置项。6. 排查方法论与避坑清单从日志出发按可能性排序6.1 从日志入手比瞎猜高效得多数据库连接失败这类问题最忌的就是不看日志盲目改配置。MySQL 的错误日志通常记录了服务启动和认证失败的详细信息PHP 的日志则会记录连接超时和扩展加载异常。在 Linux 下可以在命令行临时开 PHP 报错显示php -d display_errors1 -d error_reportingE_ALL /path/to/DVWA/index.php但这只能帮你判断 PHP 语法和扩展问题实际的数据库连接错误还是得看 MySQL 日志。XAMPP 的日志目录在C:\xampp\mysql\data\文件名为mysql_error.logLinux 下 Debian/Ubuntu 通常在/var/log/mysql/error.logCentOS 通常在/var/log/mysqld.log。我遇到过最难查的一个案例MySQL 日志里完全没有错误记录但 DVWA 就是连不上最后发现是 DVWA 目录下多了一个.user.ini文件里面设置了open_basedir把 PHP 访问数据库 socket 的路径限制死了。这种文件在共享主机上很常见本地搭建一般不会遇到但如果你的目录是从别人那里拷来的就要警惕这类隐藏配置。6.2 几类典型环境下的快速对照表我根据实际经验整理一个环境对照表方便你快速定位环境常见报错大概率解决方式XAMPP WindowsConnection refused先在 XAMPP Control Panel 里启动 MySQL并检查 3306 端口XAMPP Windows PHP8mysqli_sql_exception换 PHP 7.4或手动建库并检查扩展Linux MariaDBNo such file or directory把db_server改为127.0.0.1或统一 socket 路径Linux 手动编译 PHPAccess denied检查 MySQL 用户 host 匹配确认密码无误Docker 容器容器间无法连接使用同一个 docker networkdb_server 填容器服务名macOS MAMPConnection refusedMAMP 默认 MySQL 端口可能非 3306改端口或配置一致这里单独说下 Docker 的情况。很多人喜欢用 Docker 跑 DVWA命令通常是docker run --rm -it -p 8080:80 vulnerables/web-dvwa这个镜像本身自带数据库服务如果你的浏览器访问没问题只是提示数据库连接失败通常需要进入容器确认 MySQL 是否已启动docker exec -it 容器ID /bin/bash service mysql start然后再刷新页面。容器场景最容易忽略的点是容器重启后 MySQL 服务不会自动启动需要在容器启动脚本里处理或者每次手动启动。不过这类镜像版本较老在一些新版 Docker Desktop 上偶尔会有兼容问题遇到时优先考虑本地直接搭建。6.3 几个容易复现的坑和我的个人习惯我在本地搭建 DVWA 时养成了几个习惯能避免很多后续麻烦配置文件改完先备份再改改坏了可以秒回退。始终用127.0.0.1而不是localhost作为db_server绕开 socket 路径问题。数据库账号密码单独创建一个不给 DVWA 留太多权限但本地练习用 root 也问题不大。遇到Access denied先不要急着猜密码登录 MySQL 命令行测试同一组密码能登录说明配置问题不能登录说明密码本身有误。还有一个非常隐蔽的坑DVWA 的config.inc.php文件如果带有 BOM 头或者你在 Windows 上修改后保存成了 UTF-8 带 BOM 编码PHP 输出内容时会在头部加入不可见字符导致页面跳转失败、cookie 设置异常甚至给人一种“数据库连接有问题”的错觉。解决方案很简单用编辑器比如 VSCode把文件重新保存为 UTF-8 without BOM 格式。最后再分享一个习惯碰到数据库连接问题我会先执行php -m | grep mysql看扩展再执行mysql -u root -p -e SELECT 1测试服务端两分钟之内就能把 PHP 侧和 MySQL 侧的问题隔离出来。这个顺序能过滤掉约 80% 的常见原因剩下的再去翻配置文件和日志就不会像无头苍蝇一样乱撞。