如何排查并解决PHPStorm中Xdebug无法连接IDE的端口问题？

本文共计947个文字，预计阅读时间需要4分钟。

PHPStorm不是连接Xdebug，而是被动的等待Xdebug的主动连接。它监听的端口必须是`xdebug.client_port`指定的端口，否则连接直接失败，可能导致日志都不生成。

常见错误是：PHPStorm 默认监听 9003，但 xdebug.client_port 还留着旧习惯设成 9000；或者反过来，改了 xdebug.client_port 却忘了在 PHPStorm 的 Settings → PHP → Debug → Xdebug → Debug port 里同步修改。