环境

Windows 11 22H2
IntelliJ IDEA 2022.1.3
Docker Desktop for Windows 4.8.2

起因

打开IDEA准备开始工作时，IDEA启动失败，抛出了一个异常。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Internal error. Please refer to http://jb.gg/ide/critical-startup-errors

java.util.concurrent.CompletionException: java.net.BindException: Address already in use: bind
    at java.base/java.util.concurrent.CompletableFuture.encodeThrowable(CompletableFuture.java:314)
    at java.base/java.util.concurrent.CompletableFuture.completeThrowable(CompletableFuture.java:319)
    at java.base/java.util.concurrent.CompletableFuture$AsyncSupply.run(CompletableFuture.java:1702)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
    at java.base/java.lang.Thread.run(Thread.java:834)
Caused by: java.net.BindException: Address already in use: bind
    at java.base/sun.nio.ch.Net.bind0(Native Method)
    at java.base/sun.nio.ch.Net.bind(Net.java:455)
    at java.base/sun.nio.ch.Net.bind(Net.java:447)
    at java.base/sun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:227)
    at io.netty.channel.socket.nio.NioServerSocketChannel.doBind(NioServerSocketChannel.java:132)
    at io.netty.channel.AbstractChannel$AbstractUnsafe.bind(AbstractChannel.java:551)
    at io.netty.channel.DefaultChannelPipeline$HeadContext.bind(DefaultChannelPipeline.java:1346)
    at io.netty.channel.AbstractChannelHandlerContext.invokeBind(AbstractChannelHandlerContext.java:503)
    at io.netty.channel.AbstractChannelHandlerContext.bind(AbstractChannelHandlerContext.java:488)
    at io.netty.channel.DefaultChannelPipeline.bind(DefaultChannelPipeline.java:985)
    at io.netty.channel.AbstractChannel.bind(AbstractChannel.java:247)
    at io.netty.bootstrap.AbstractBootstrap$2.run(AbstractBootstrap.java:344)
    at io.netty.util.concurrent.AbstractEventExecutor.safeExecute(AbstractEventExecutor.java:163)
    at io.netty.util.concurrent.SingleThreadEventExecutor.runAllTasks(SingleThreadEventExecutor.java:510)
    at io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:518)
    at io.netty.util.concurrent.SingleThreadEventExecutor$6.run(SingleThreadEventExecutor.java:1044)
    at io.netty.util.internal.ThreadExecutorMap$2.run(ThreadExecutorMap.java:74)
    at io.netty.util.concurrent.FastThreadLocalRunnable.run(FastThreadLocalRunnable.java:30)
    ... 1 more

-----
JRE 11.0.5+10-b520.30 amd64 by JetBrains s.r.o

异常显示，IDEA运行需要的服务端端口被占用，导致无法启动。

排查

IDEA启动时，会启动一个本地的服务端，需要申请一个端口号使用。端口号申请规则是从6942到6991，取第一个可用的端口。既然这样，那就先查询6942是否被其他程序占用了。

  1. 查询端口号是否被占用
1
netstat -ano | findstr 6942

发现没有程序占用。

  1. 查询端口号是否被系统预留给了其他程序
1
netsh interface ipv4 show excludedportrange protocol=tcp

查看结果

1
2
3
4
5
6
7
8
9
10
协议 tcp 端口排除范围

开始端口    结束端口
----------    --------
...
      6900        6949
      6950        6999
...

* - 管理的端口排除。

这时可以看到，端口被系统排除掉不能使用。

这其中涉及到Windows10以上版本的系统中的受管端口排除。在启用Hyper-V之后，系统会申请一部分端口留用。正巧在问题出现以前，我手贱更新了Docker Desktop（运行时需要Hyper-V支持）。

解决思路和步骤

受管端口是可以用户自定义的。既然Hyper-V会申请保留一部分端口，那就在Hyper-V占用之前，自定义保留所需要的端口，保证IDEA在申请端口的时候，可以顺利申请到。

确定思路就开始行动。

1. 关闭Hyper-V

管理员身份运行PowerShell，运行以下命令。

1
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All

运行之后重启系统。

2. 保留IDEA需要的端口

1
netsh int ipv4 add excludedportrange protocol=tcp startport=6942 numberofports=50

3. 启动Hyper-V

1
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All

重启系统之后，IDEA就可以运行了。

查看受管端口排除列表，可以看到自定义规则已经生效了。

1
2
3
4
5
6
7
8
9
10
11
12
协议 tcp 端口排除范围

开始端口    结束端口
----------    --------
...
      5426        5426
      6942        6991     *
...
      9281        9380
     50000       50059     *

* - 管理的端口排除。