VS Code 调试的是 PHP 中 MySQL 交互逻辑而非 MySQL 服务本身；需检查连接错误、启用异常模式、断点查看真实 SQL 和参数、命令行验证查询、确认 Xdebug 配置正确、查阅 PHP 错误日志定位问题。
VS Code 本身不直接调试 MySQL，它调试的是 PHP 脚本中与 MySQL 的交互逻辑——比如 mysqli 或 PDO 调用失败、查询结果为空、SQL 拼接错误、连接超时等。真正要排查的，是 PHP 层面的数据库行为，不是 MySQL 服务本身。
确认 PHP 确实连上了 MySQL，而不是“假成功”
很多问题出在 mysqli_connect() 或 new PDO() 看似返回了对象，但实际连接失败却被静默忽略。PHP 默认关闭错误报告，mysqli 的构造函数即使失败也可能返回 mysqli 实例（内部状态为断开），而 PDO 默认不抛异常。
- 对
mysqli：务必检查$mysqli->connect_error或调用前设置mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT) - 对
PDO：初始化时必须传入选项[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]，否则query()失败只会返回false，不报错 - 不要只看“有没有报致命错误”，要主动检查
$stmt->execute()返回值或捕获PDOException
在 VS Code 中打断点看 SQL 和参数到底长什么样
你写的 $sql = "SELECT * FROM user WHERE id = $id" 很可能在运行时拼出 WHERE id = （空值）或引发 SQL 注入；预处理语句的绑定参数是否生效，光看代码看不出。VS Code 的 PHP Debug 扩展（如 Xdebug 或 Zend Debugger）能让你停在 $stmt->execute() 前，展开变量看 $sql 字符串和 $params 数组真实值。
- 在
$stmt->execute($params)上方设断点，鼠标悬停或在 Debug 控制台输入print_r($sql)/var_dump($params) - 对 PDO 预处理，注意
$stmt->queryString是原始 SQL（含问号），$stmt->debugDumpParams()会输出绑定详情（需在 CLI 下才可见，Web 请求中建议用error_log()记录） - 避免在断点后直接修改变量再继续——某些扩展对运行中修改绑定参数支持不稳定
查不到数据？先绕过 PHP，用 MySQL 命令行验证 SQL 是否真能跑通
VS Code 里单步看到 $result->num_rows === 0，不代表 SQL 有语法错误，更可能是条件写错、表名大小写不匹配（Linux 下敏感）、时区/字符集导致 WHERE created_at > '2024-01-01' 不命中，或者权限只给了 SELECT 但脚本还试图 INSERT。
立即学习“PHP免费学习笔记（深入）”；
- 把断点中看到的真实
$sql复制出来，在终端执行：mysql -u your_user -p -e "USE your_db; SELECT * FROM user WHERE id = 123;"
- 重点比对：数据库名、表名、字段名是否全小写（尤其从 Windows 迁移到 Linux 服务器时）
- 如果命令行能查到，但在 PHP 里查不到，大概率是字符集问题——检查 PHP 连接时是否执行了
SET NAMES utf8mb4，或 PDO DSN 中是否含;charset=utf8mb4
Xdebug 配置不对，断点根本不会停，白搭
VS Code 的 PHP Debug 插件只是客户端，真正驱动调试的是 PHP 加载的 Xdebug 扩展。常见失效场景：Xdebug 版本与 PHP 不兼容、xdebug.mode=debug 没开、xdebug.client_host 指向错误（Docker 环境常填成 localhost 而非 host.docker.internal）、IDE key 不匹配。
- 运行
php -v确认输出含 Xdebug 且版本 ≥ 3.1（推荐）；运行php --ri xdebug查看配置项实际值 - 关键配置必须存在（PHP.ini 中）：
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes - VS Code 的
launch.json中port必须与xdebug.client_port一致；pathMappings要精确映射容器内路径到本地文件路径（如"${workspaceFolder}/app": "/var/www/html"）
最常被忽略的一点：MySQL 的错误日志默认不记录慢查询以外的失败连接，而 PHP 层的连接拒绝（如 Connection refused）往往只在 PHP 错误日志里体现。别只盯着 VS Code 的 Debug 控制台——打开 php.ini 中的 error_log 对应文件，搜索 mysqli、PDO、Connection 关键词，那里才有真实线索。
