Mac OS下SpringBoot端口无占用却出现socket绑定失败求助

核心成因 #

该异常是macOS内核的动态端口保留机制触发的假占用，不存在实际占用端口的进程：

• 新版macOS会为系统出站网络连接预留一段动态端口范围，范围内的端口即便没有任何进程监听，应用发起bind请求时，内核也会直接返回OSError: [Errno 48] Address already in use
• 你在Python脚本里设置的SO_REUSEADDR选项无法绕过这个限制，这个选项仅允许复用处于TIME_WAIT状态的空闲端口，对内核层面的端口保留规则没有任何作用
• 由于没有实际运行的监听进程，lsof、netstat这类枚举活跃网络进程的命令，不会输出任何和目标端口相关的记录，telnet尝试连接时也会直接返回连接拒绝（无进程响应请求）
• 重启电脑无法解决问题，因为这段端口保留范围是系统启动阶段就加载的内核配置，重启后规则依然生效
• 其他端口可以正常绑定，本质是这些端口不在系统的动态保留区间内

快速验证方式 #

在终端执行以下命令，查看系统当前的动态保留端口覆盖范围：
sudo sysctl net.inet.ip.portrange.first net.inet.ip.portrange.last net.inet.ip.portrange.reservedhigh net.inet.ip.portrange.reservedlow
如果输出的区间覆盖55555，即可确认是该机制导致的异常。常见的踩坑场景是部分macOS版本默认的动态端口范围为49152-65535，55555刚好落在这个区间内，触发了内核的保留规则。

处理方案 #

• 优先调整应用的监听端口，选择不在系统保留区间内的端口使用，这是无额外配置成本的最简方案
• 如果必须固定使用55555端口，可手动调整系统动态端口的分配起点，将目标端口从保留区间内排除：
  临时生效（重启后失效）执行命令：sudo sysctl -w net.inet.ip.portrange.first=55556
  永久生效可将上述配置写入系统sysctl配置文件，实现重启后依然保持规则
• 调整端口范围时需注意，不要将动态保留区间设置得过小，否则会导致系统出站连接无可用端口触发网络异常，调整时保证保留区间的覆盖范围足够支撑系统常规出站连接需求即可。

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