Spring Boot application.yml配置未生效问题排查求助

我的8080端口被占用，于是修改Spring Boot项目的application.yml，将server.port设为9098，同时把Kafka生产者的bootstrap-servers设为localhost:9093来验证配置是否生效。执行启动命令：

mvn spring-boot:run -Dspring.config.location=file:/src/main/resources/application.yml,classpath:application.yml

已确认target/classes下的application.yml配置正确，内容如下：

spring:
  kafka:
    producer:
      bootstrap-servers: localhost:9093
      key-serializer: org.apache.kafka.common.serialization.StringSerializer
      value-serializer: org.apache.kafka.common.serialization.StringSerializer
  server:
    port: 9098

但启动日志显示Tomcat仍以8080端口初始化，Kafka使用默认的9092端口，最终项目启动失败，日志片段：

***************************
APPLICATION FAILED TO START
***************************

Description:

Web server failed to start. Port 8080 was already in use.

2023-10-28 19:12:25.957  INFO 51238 --- [           main] c.c.KafkaDemo.KafkaDemoApplication       : No active profile set, falling back to 1 default profile: "default"
2023-10-28 19:12:26.808  INFO 51238 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8080 (http)
...
2023-10-28 19:12:27.380  INFO 51238 --- [           main] o.a.k.clients.consumer.ConsumerConfig    : ConsumerConfig values:
    ...
    bootstrap.servers = [localhost:9092]
    ...

项目pom.xml内容：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.codedecode</groupId>
    <artifactId>KafkaDemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>KafkaDemo</name>
    <description>Demo project for Kafka implementation</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.kafka</groupId>
            <artifactId>spring-kafka</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.kafka</groupId>
            <artifactId>spring-kafka-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>


        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <targetPath>${project.build.outputDirectory}</targetPath>
                <includes>
                    <include>application.yml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>

</project>

另外，IntelliJ中找不到application.yml，启动类代码：

@SpringBootApplication
public class KafkaDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(KafkaDemoApplication.class, args);
    }

}

疑问：是否是Spring Boot启动类注解使用错误？还是有其他原因导致配置未生效？

首先，启动类的@SpringBootApplication注解没有问题，这个注解包含了@Configuration、@EnableAutoConfiguration和@ComponentScan，是Spring Boot项目的标准启动注解，不会导致配置不生效。配置未生效的核心原因及解决办法如下：

1. spring.config.location参数路径错误 #

你使用的file:/src/main/resources/application.yml路径格式有误：类Unix系统下绝对路径需要三个斜杠（file:///），相对路径则不需要file:前缀。同时多配置文件的优先级是前面覆盖后面，如果指定的路径不存在，会导致配置加载失败，Spring Boot自动 fallback 到默认配置。

解决办法：

• 使用相对路径启动，无需file:前缀：

  mvn spring-boot:run -Dspring.config.location=src/main/resources/application.yml,classpath:application.yml
  

• 或使用正确的绝对路径格式（替换为你的实际路径）：

  mvn spring-boot:run -Dspring.config.location=file:///Users/yourname/Documents/springboot/codedecode25/src/main/resources/application.yml,classpath:application.yml
  

• 最简方式：若已执行mvn clean install，target/classes下已有正确配置，直接省略参数，Spring Boot会自动从classpath加载：

  mvn spring-boot:run
  

2. IntelliJ未识别资源目录 #

IntelliJ中找不到application.yml，大概率是src/main/resources未被标记为资源目录，导致IDE编译时未正确处理配置文件。

解决办法：

• 检查src/main/resources目录是否存在，确认application.yml在该目录下；
• 右键点击src/main/resources → Mark Directory as → Resources Root，标记为资源目录；
• 执行mvn clean compile重新编译项目。

3. Kafka Consumer未配置bootstrap-servers #

日志显示Consumer使用默认9092端口，是因为你只配置了Producer的bootstrap-servers，若项目用到Consumer，需单独配置：

spring:
  kafka:
    producer:
      bootstrap-servers: localhost:9093
      key-serializer: org.apache.kafka.common.serialization.StringSerializer
      value-serializer: org.apache.kafka.common.serialization.StringSerializer
    consumer:
      bootstrap-servers: localhost:9093
      key-deserializer: org.apache.kafka.common.serialization.StringDeserializer
      value-deserializer: org.apache.kafka.common.serialization.StringDeserializer
  server:
    port: 9098

4. YAML文件缩进错误 #

YAML对缩进要求严格，必须用空格（不能用Tab），层级缩进不一致会导致配置项被忽略。

解决办法：
检查application.yml的缩进，确保server与kafka同属spring的子节点，每个层级使用2或4个空格（保持统一即可）。

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