Spring Boot 3中如何修改Tomcat服务器默认端口？

针对你遇到的application.properties里server.port不生效的问题，按以下步骤逐一排查：

• 确认配置文件位置与命名
  确保application.properties放在src/main/resources目录下，这是Spring Boot默认加载的配置路径；同时检查文件名拼写，避免出现application.properites这类错误。

• 检查配置项大小写
  Spring Boot配置项区分大小写，正确的配置格式是：

  server.port=8081
  

  不要写成Server.port或SERVER.PORT，大写开头的配置项无法被框架识别。

• 排查是否存在配置覆盖

  • 启动参数：如果启动时添加了--server.port=xxx命令行参数，会优先覆盖配置文件设置；
  • 环境变量：系统环境变量中的SERVER_PORT会拥有更高优先级，覆盖配置文件；
  • 多环境配置：如果激活了特定profile（比如dev、prod），对应application-{profile}.properties中的server.port会覆盖主配置文件。

• 检查自定义Web服务器配置
  若代码中存在硬编码设置端口的Bean，会直接覆盖配置文件，比如：

  @Bean
  public WebServerFactoryCustomizer<TomcatServletWebServerFactory> webServerCustomizer() {
      return factory -> factory.setPort(8080);
  }
  

  这种情况需要修改代码中的端口值，或者移除该硬编码配置。

• 验证Web依赖是否存在
  确认项目已引入spring-boot-starter-web依赖，没有该依赖的话Spring Boot不会启动内嵌Web服务器，server.port配置自然无效。Maven依赖示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  

• 清理缓存重新构建
  尝试执行mvn clean install（Maven项目）或clean build（Gradle项目）清理构建缓存，再重新启动应用，避免IDE缓存导致配置未加载。

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