Spring Boot 官方不支持在指定端口范围内动态选取空闲端口；推荐做法是使用 server.port=0 启用随机端口，由操作系统分配，再通过 @Value("${local.server.port}") 或 ServletWebServerApplicationContext 获取实际端口号。

spring boot 官方不支持在指定端口范围内动态选取空闲端口；推荐做法是使用 `server.port=0` 启用随机端口，由操作系统分配，再通过 `@value("${local.server.port}")` 或 `servletwebserverapplicationcontext` 获取实际端口号。

在微服务架构中，为实现同一虚拟机上多实例部署与负载均衡，常需避免端口冲突。但需明确：Spring Boot（尤其是 3.x / 6.x+ 版本）已移除 SocketUtils 等用于端口探测的内部工具类，并明确不鼓励、也不支持在生产环境主动扫描端口可用性。官方文档强调，此类逻辑违背云原生设计原则——端口应由运行时环境（如容器编排系统）或操作系统统一管理，而非应用自行争抢。

✅ 正确且推荐的方案是启用随机端口模式：

1. 在 application.yml 中配置：

   

   Spring Boot 3.3.13

   Spring Boot下载页提供 3.3.13 官方源码 ZIP，并整理快速入门、项目创建、配置和自动配置说明。

   下载

   server:
   port: 0  # 启用随机端口分配

2. 启动后获取实际绑定端口（适用于健康检查、服务注册等场景）：

   @Component
   public class PortReporter implements ApplicationRunner {
    @Autowired
    private ServletWebServerApplicationContext context;
   
    @Override
    public void run(ApplicationArguments args) {
        int actualPort = context.getWebServer().getPort();
        System.out.println("Microservice started on port: " + actualPort);
        // 可进一步上报至 Consul/Eureka/Nacos 等注册中心
    }
   }

⚠️ 注意事项：

• server.port=0 是唯一被 Spring Boot 官方支持并保证稳定的动态端口方案；
• 不要尝试基于 InetSocketAddress 或 ServerSocket 手动遍历端口范围（如 8080–8090），这易引发竞态条件、端口误判及资源泄漏；
• 若业务强依赖“固定范围内的端口”（如防火墙策略限制），应在基础设施层解决：例如 Docker 使用 --publish-all + docker inspect 获取映射端口，或 Kubernetes 通过 Service 和 NodePort/ClusterIP 统一调度；
• @Value("${local.server.port}") 仅在 Web 环境中有效，且值在上下文刷新后才可用，不可用于 @PostConstruct 等早期初始化阶段。

总结：拥抱 Spring Boot 的约定优于配置理念——用 server.port=0 交出端口控制权，专注业务逻辑；将端口治理交给平台层，才是高可用、可伸缩微服务的正确实践路径。