PhpStorm断点不触发的主因是监听未开启、端口错配或Xdebug未连通；需检查phpinfo中xdebug.mode=debug且status=enabled，校准PHP解释器、Debug端口（9003）、服务器路径映射，并每次手动执行“Start Listening for PHP Debug Connections”。
确认 PhpStorm 是否真的“丢失”了调试配置
断点不触发，不等于设置被清空——更常见的是监听没开、端口错配或 Xdebug 没连上。先别急着重置，用 phpinfo() 页面检查 xdebug.mode 值是否为 debug，且 xdebug.status 显示 enabled。如果这里已经是 disabled 或压根没出现 Xdebug 模块，问题根本不在 PhpStorm，而在 PHP 环境本身。
重置 PHP Debug 和 Server 配置的关键项
PhpStorm 的调试能力依赖三个核心配置联动：PHP 解释器、Debug 端口、Server 路径映射。恢复不是“一键还原”，而是逐项校准：
-
Settings/Preferences → Languages & Frameworks → PHP → Debug：确保Debug port是9003（Xdebug 3.x 默认），勾选Can accept external connections -
PHP → Servers：删掉旧的 localhost 条目，新建一个，Host填127.0.0.1（别用localhost），Port填你 Web 服务实际端口（如80或8080），必须勾选Use path mappings，并把本地项目路径（如/home/user/project）映射到服务器文档根目录（如/var/www/html） - 检查
PHP Interpreter是否指向正确版本：路径错误会导致xdebug.so加载失败，即使 php.ini 写对也白搭
为什么重启监听比重启 IDE 更关键
很多人点了绿色虫子图标就以为在调试，其实那只是运行脚本；真正启动调试握手的是手动监听动作。每次改完配置、重启 Apache/Nginx 或切换 PHP 版本后，都必须执行：Run → Start Listening for PHP Debug Connections。右下角出现 Debug listening… 才算生效。这个状态不会自动持久，关掉 IDE 就消失，下次打开得重点一次。
浏览器端常被忽略的触发条件
断点打好了、监听开了、路径映射对了，但还是不进断点？大概率卡在请求没带调试标识：
立即学习“PHP免费学习笔记（深入）”；
- Chrome/Firefox 必须装
JetBrains IDE Support插件，并右键图标 →Options→IDE key设为PHPSTORM（需和 php.ini 中xdebug.idekey一致） - 访问 URL 时，要么手动加参数
?XDEBUG_SESSION_START=PHPSTORM，要么点击浏览器插件图标启用（图标变绿才生效） - Postman 等工具调试 API 时，必须手动加 Cookie：
XDEBUG_SESSION=PHPSTORM，仅传XDEBUG_SESSION_START参数不够
路径映射错一个字符、xdebug.client_host 写成 localhost、监听状态未激活——这三处出问题的概率加起来超过 70%。别迷信“恢复默认设置”，先盯住这三个点。
