如何在测试时调试Symfony控制器（Guzzle/PHPUnit/PhpStorm环境）

我之前也碰到过一模一样的问题——测试类里的断点能正常触发，但客户端请求打到控制器里就完全没反应，明明请求确实到了控制器（改状态码测试能看到变化）。下面是我试过的有效解决方法，按优先级排序：

• 给测试客户端带上Xdebug会话参数
  默认情况下，Symfony的测试客户端发送请求时不会自动携带Xdebug的触发参数，导致PhpStorm抓不到控制器里的调试会话。你可以在测试类的setUp方法里初始化客户端时加上这个参数：

  protected function setUp(): void
  {
      // 开启调试模式的客户端
      $this->client = static::createClient([], [
          'HTTP_XDEBUG_SESSION' => 'PHPSTORM'
      ]);
  }
  

  这个参数会告诉Xdebug在处理请求时主动连接PhpStorm的调试监听。

• 确保PhpStorm的调试监听已开启
  检查PhpStorm右上角的「电话」图标，必须是亮着的状态（点击可以切换开启/关闭）。如果没开启，就算请求带了Xdebug参数，PhpStorm也不会接收调试连接。

• 验证Xdebug配置正确性
  打开你的php.ini（或者xdebug.ini），确认以下配置：

  xdebug.mode = debug
  xdebug.client_host = localhost  # 如果是Docker/虚拟机，改成宿主机IP，比如172.17.0.1
  xdebug.client_port = 9003       # 要和PhpStorm设置里的端口一致（默认是9003）
  xdebug.start_with_request = yes
  

  改完配置后记得重启PHP服务（比如FPM或者CLI）。

• 检查路径映射（针对Docker/虚拟机环境）
  如果你的项目是在容器或者虚拟机里运行的，一定要在PhpStorm里配置正确的路径映射：

  1. 打开Settings > Languages & Frameworks > PHP > Servers
  2. 添加一个新服务器，填写容器/虚拟机的主机和端口
  3. 在「Path mappings」里把本地项目的根目录映射到容器内的项目根目录
     路径不匹配的话，PhpStorm会找不到对应的本地文件，自然不会触发断点。

• 强制触发Xdebug断点
  如果上面的方法都没用，可以在控制器的newAction开头加一行xdebug_break();，强制触发Xdebug连接。如果这时候PhpStorm能捕获到断点，说明之前的参数传递有问题；如果还是没反应，那大概率是Xdebug本身的配置或者PhpStorm的调试监听没弄对。

• 排查PhpStorm的调试排除规则
  检查Settings > Build, Execution, Deployment > Debugger > Stepping里的「Do not step into the following classes and methods」列表，确保没有把Symfony的控制器或者你的项目代码排除在外。

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