Spring Boot端口冲突应先用lsof或netstat定位占用进程，再通过server.port=0自动分配端口并配合management.server.port=${server.port}统一管理，同时按profile隔离配置、IDE和Maven需同步激活dev profile。
Spring Boot启动报Address already in use怎么快速定位谁占了端口
直接用命令查，别重启IDE或瞎猜。Linux/macOS执行lsof -i :8080（把8080换成你实际报错的端口号）；Windows用netstat -ano | findstr :8080，再配合tasklist | findstr <code>pid看进程名。常见占端口的是上一次没关干净的Spring Boot实例、IDE内置服务器、Docker容器，或者本地起了另一个java进程。
application.yml里配置server.port=0让Spring Boot自动选空闲端口
这是最轻量的解法，适合开发调试和CI场景。设成0后Spring Boot会随机绑定一个可用端口，并在日志里输出真正用了哪个——比如Tomcat started on port(s): 56789 (http)。注意：server.port=0只对内嵌容器生效（Tomcat/Jetty/Netty），不适用于部署到外部Servlet容器。
- 如果用
@Value("${server.port}")注入端口号，得确保应用已完全启动后再读，否则可能拿到0这个占位值 - 集成测试时若依赖固定端口（比如
@WebMvcTest配了MockMvc），server.port=0会导致测试失败，得单独配testprofile关掉它 - 微服务注册到Nacos/Eureka时，自动端口需配合
server.address和spring.application.instance-id避免实例ID重复
用spring.profiles.active区分开发/测试环境的端口策略
硬编码server.port=0进主配置容易误带到生产，应该按环境隔离。在application-dev.yml里写server.port=0，在application-prod.yml里明确写server.port=8080，启动时加--spring.profiles.active=dev。IDE里Run Configuration也要同步改Active profiles，不然IDE默认走default profile，还是报错。
- IntelliJ用户容易漏掉：右键运行类时，它默认不读
application-{profile}.yml，得在Run Configuration → Environment → Active profiles里手动填dev - 如果项目用了
spring-boot-maven-plugin打包，mvn spring-boot:run -Dspring-boot.run.profiles=dev才能生效 -
server.port是Environment属性，会被JVM参数覆盖，比如-Dserver.port=9090优先级高于yml，调试时留意有没有被意外覆盖
端口冲突还发生在management.server.port上
很多人只改了server.port，但忘了Actuator的管理端口也默认8080。如果主服务用了0，管理端点却还卡在8080，照样报错。统一配成management.server.port=${server.port}就行，或者单独设为-1彻底关闭管理端点（仅限本地调试）。
-
management.endpoints.web.exposure.include=*暴露所有端点时，必须确保management.server.port不冲突，否则/actuator/health等请求直接503 - Docker环境下，
management.server.port要映射到宿主机不同端口，比如-p 8081:8081，否则容器内两个端口都绑0会导致不可预测行为 - Spring Boot 3.x开始，
management.server.port默认和server.port分离，不显式配置就容易踩这个坑
server.port、management.server.port、Profile激活方式、IDE运行配置、Docker端口映射这五处只要有一处没对齐，就会反复报错。最稳的做法是：开发机统一用dev profile + server.port=0 + management.server.port=${server.port}，其他地方全删掉硬编码端口。 
