使用Selenium ChromeDriver时如何解决调试器冻结问题？

实用排查步骤 #

1. 切断调试器对所有子进程的自动附加 #

ChromeDriver启动后会拉起Chrome浏览器子进程，若IDE调试器开启了自动附加所有子进程，大概率会因进程数量过多、权限冲突卡住。

• 进入IDE调试配置，关闭"自动附加到子进程"选项（比如IntelliJ在Run/Debug Configurations -> Debugger中找到对应开关）。
• 改用远程连接方式初始化WebDriver，绕开调试器直接附加的问题：

  // 先手动在命令行启动ChromeDriver：chromedriver --port=9515
  ChromeOptions options = new ChromeOptions();
  WebDriver driver = new RemoteWebDriver(new URL("http://localhost:9515"), options);
  

2. 修复依赖版本适配问题 #

• 你使用的WebDriverManager 3.x与Selenium 4.x存在兼容性盲区，直接升级WebDriverManager到最新稳定版（如5.x系列），同时确保ChromeDriver版本与本地Chrome浏览器大版本完全一致。
• 强制指定ChromeDriver版本，避免WebDriverManager自动下载不兼容版本：

  WebDriverManager.chromedriver().driverVersion("114.0.5735.90").setup(); // 替换为你Chrome对应的版本
  

3. 调整JVM调试参数 #

• 在IDE的VM Options中添加-Djdk.attach.allowAttachSelf=true，解决调试器附加进程时的权限限制。
• 移除-XX:+DebugNonSafepoints这类JIT编译调试参数，部分环境下该参数会导致调试器在进程启动阶段阻塞。

4. 排查系统级阻塞 #

• 检查防火墙、杀毒软件是否拦截了ChromeDriver/Chrome的进程通信，尤其是调试器依赖的进程间通信端口。
• 监控系统资源占用，若ChromeDriver或Chrome启动后内存/CPU占满，会导致调试器无法响应，可通过任务管理器排查。

5. 重置IDE与极简项目验证 #

• 清理IDE缓存（如IntelliJ的File -> Invalidate Caches...）后重启，排除缓存损坏导致的调试异常。
• 新建极简测试项目，仅保留核心依赖，写最基础的启动代码，排查是否是原有项目的依赖冲突或配置问题：

  import org.openqa.selenium.chrome.ChromeDriver;
  import org.openqa.selenium.chrome.ChromeOptions;
  import io.github.bonigarcia.wdm.WebDriverManager;
  
  public class DebugTest {
      public static void main(String[] args) {
          WebDriverManager.chromedriver().setup();
          ChromeOptions options = new ChromeOptions();
          options.addArguments("--headless=new");
          ChromeDriver driver = new ChromeDriver(options);
          System.out.println("Driver initialized");
          driver.get("https://www.google.com");
          driver.quit();
      }
  }
  

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