IntelliJ构建异常终止：127.0.0.1:49153端口占用问题求助

问题场景 #

无错误警告的Java算法程序在IntelliJ中运行时，间歇性触发“Abnormal build process termination”错误，核心报错为：

Error connecting to 127.0.0.1:49153; reason: Address already in use: getsockopt: /127.0.0.1:49153
io.netty.channel.AbstractChannel$AnnotatedSocketException: Address already in use: getsockopt: /127.0.0.1:49153

已尝试解除Windows Defender拦截、Maven clean、重建项目、升级IntelliJ和Java版本等操作，问题仍未解决。

有效解决方案 #

• 定位并释放占用端口的进程

  1. 打开CMD或PowerShell，执行命令查找目标端口的占用进程：

     netstat -ano | findstr :49153
     

  2. 根据输出的PID，强制终止进程：

     taskkill /F /PID <查询到的PID>
     

  若每次报错端口不同，说明是随机端口被占用，需尝试下方方案。

• 指定IntelliJ构建进程的端口范围

  1. 打开IntelliJ设置（File > Settings），搜索进入Build, Execution, Deployment > Build Tools > Maven > Runner（Maven项目），或直接搜索Build Process。
  2. 在VM Options中添加端口范围参数，示例：

     -Djava.rmi.server.hostname=127.0.0.1 -Dbuild.process.port=49200-49300
     

  3. 保存设置后重启IntelliJ测试。

• 禁用构建自动缓存与自动构建

  1. 进入IntelliJ设置，搜索Build, Execution, Deployment > Compiler。
  2. 取消勾选Build project automatically和Allow auto-make to start even if developed application is currently running。
  3. 执行Clean Project，重启后重新运行程序。

• 排查常驻网络程序的端口占用
  后台代理工具、第三方杀毒软件、其他IDE的后台进程可能占用大量本地端口，导致IntelliJ构建端口冲突：

  • 打开任务管理器，结束不必要的常驻网络进程；
  • 暂时关闭代理、杀毒软件，验证问题是否消失。

• 重置IntelliJ缓存

  1. 关闭IntelliJ，启动时按住Shift键，选择Invalidate Caches...；
  2. 勾选Invalidate and Restart，重启后重新导入项目构建运行。

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