一、Spring Boot配置文件中的“陷阱”

spring boot的配置文件是指导spring boot应用运行的重要文件，是一个全局的配置文件。与spring、spring mvc、mybatis等框架的配置文件相比，spring boot的配置文件更加简化，底层默认做了很多配置。spring boot的配置文件默认放在resources目录下，且文件名必须为application。

Spring Boot存在两种形式的配置文件，分别是properties和yml格式。在两种配置文件同时存在的情况下，properties格式的配置文件优先级更高。与之相比，yml格式配置文件更加简洁明了、紧凑且可读性高，Spring Boot支持并推荐使用yml格式配置文件。

工程搭建

新建一个Maven工程spring-boot-traps，在pom.xml文件中添加依赖以及Maven插件，完整的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.6.3</version>
        <relativePath/>
    </parent>
    <groupId>com.citi</groupId>
    <artifactId>spring-boot-traps</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>spring-traps</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.8.1</version>
        </dependency>
    </dependencies>
    <build>
        <finalName>${artifactId}</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

登录后复制

在com.citi.spring.traps包下新增主启动类TrapsApplication：

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

登录后复制

在test包的相同路径下增加主启动类的测试类TrapsApplicationTest：

@SpringBootTest
public class TrapsApplicationTest {
    @Test
    public void context() {
        ApplicationContext context = new AnnotationConfigApplicationContext("com.citi.spring.traps");
        String[] beanDefinitionNames = context.getBeanDefinitionNames();
        for (String beanDefinitionName : beanDefinitionNames) {
            System.out.println("容器中的对象:" + beanDefinitionName);
        }
    }
}

登录后复制

执行测试：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

Spring容器可以正常运行。

配置文件加载顺序的“陷阱”

使用配置文件给实体类赋值，在entity包下新增UserProperties：

@Data
@Component
@ConfigurationProperties(prefix = "traps.user")
public class UserProperties {
    private String name;
    private Integer age;
}

登录后复制

@ConfigurationProperties注解可以指定配置文件中配置项的前缀。

在application.yml中增加配置：

traps:
  user:
    name: stark
    age: 41

登录后复制

增加UserProperties的测试类：

public class UserPropertiesTest extends TrapsApplicationTest {
    @Autowired
    private UserProperties userProperties;
<pre class="brush:php;toolbar:false;"><code>@Test
public void getProperty() {
    System.out.println(userProperties);
}

登录后复制

}

执行测试：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

根据控制台打印日志，可以看出UserProperties被成功赋值。

配置文件优先级

工程目录下的配置文件优先级如下：

工程目录下/config/application.yml，优先级最高
工程目录下/application.yml，优先级第二
resources/config/application.yml，优先级第三
resources/application.yml，优先级第四

不同位置都放置了配置文件，高优先级的配置会覆盖低优先级的配置，多个配置文件是互补的，即取多个文件的并集。

验证配置文件优先级：

在resource目录下新建config文件夹，增加application.yml：

traps:
user:
name: stark in resources/config/
age: 41

登录后复制

执行测试：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

根据控制台打印出的日志，可以确定resources目录下的application.yml被config目录下的application.yml覆盖了。

在工程根目录下新增application.yml：

traps:
user:
name: stark in root/
age: 41

登录后复制

执行测试：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

根据控制台日志打印，可以确定工程根目录下的配置文件覆盖了resource目录下的两个配置文件。

在工程根目录下新建config目录，在config目录下新增application.yml：

有道小P

有道小P，新一代AI全科学习助手，在学习中遇到任何问题都可以问我。

查看详情

traps:
user:
name: stark in root/config/
age: 41

登录后复制

执行测试：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

根据控制台日志打印，可以确定工程根目录下config文件下的配置文件的优先级是最高的。

`application.yml`多环境配置

第一种方式可以使用spring.profile.active指定配置文件。

在resources目录下新建两个配置文件application-dev.yml、application-test.yml：

traps:
user:
name: stark in dev
age: 41

登录后复制

traps:
user:
name: stark in test
age: 41

登录后复制

修改application.yml，使用spring.profile.active指定使用的配置文件：

spring:
profiles:</p><h1>指定使用的配置文件</h1><pre class="brush:php;toolbar:false;"><code>active: test</code></pre><p>删除<code>config</code>目录，执行测试：</p><p><img src="/uploads/20250419/17450228926802efac046ec.jpg" alt="你有没有掉进去过这些Spring Boot中的“陷阱“（上）" /></p><p>根据控制台的日志可以确定，使用的配置文件为<code>test</code>环境的配置文件。</p><p>第二种方式是使用占位符，即启动应用时指定使用哪个环境的配置。修改<code>application.yml</code>：</p><pre><code class="yaml">spring:

登录后复制

profiles:

使用占位符

<code>active: ${spring.profiles.active}</code></pre><p>使用Maven命令打包，在终端中执行启动命令并指定配置文件：</p><pre><code class="bash">java -jar spring-boot-traps.jar --spring.profiles.active=test</code></pre><p>终端启动日志如下：</p><p><img src="/uploads/20250419/17450228926802efacad4e5.jpg" alt="你有没有掉进去过这些Spring Boot中的“陷阱“（上）" /></p><p>控制台日志显示使用的配置文件是<code>test</code>。</p><h3>定时任务执行的“陷阱”</h3><p>Spring Boot中可以非常简单的实现定时任务，而且定时任务有自己独立的线程池，不会影响到业务主线程。</p><p>Spring Boot中编写定时任务需要用到两个注解：</p><ul><li><code>@EnableScheduling</code>标注在配置类上使<code>@Scheduled</code>注解生效</li><li><code>@Scheduled</code>注解标注在方法上，表示这是一个定时任务</li></ul><p><code>@Scheduled</code>注解的参数包括：</p><ul><li><code>fixedDelay</code>：上次任务的结束和下次任务的开始之间的固定间隔多少秒</li><li><code>fixedRate</code>：上次任务的开始和下次任务开始之间的频率，不管任务是否结束</li><li><code>initialDelay</code>：与<code>fixedDelay</code>和<code>fixedRate</code>组合使用，指的是第一次任务等待指定的时间后才开始执行</li><li><code>cron</code>：表达式配置任务执行时间</li></ul><p>编写定时任务类：</p><p>新建<code>task</code>目录，新增<code>ScheduledTask</code>类，定义定时任务：</p><pre><code class="java">@Component</code>

登录后复制

@Slf4j public class ScheduledTask { @Scheduled(fixedRate = 1000) public void task01() throws InterruptedException { log.info("Scheduled task01 processing"); while (true) { Thread.sleep(2000); log.info("Scheduled Task process something"); } }

<code>@Scheduled(fixedRate = 1000)
public void task02() throws InterruptedException {
    log.info("Scheduled task02 processing");
}</code>

登录后复制

}

在主启动类上增加注解@EnableScheduling，表示启用定时任务。

启动主程序类，观察控制台打印的日志：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

根据打印的日志可以发现，只有task01在运行，task02并没有运行，这是为什么？

点击主启动类上的@EnableScheduling注解，查看ScheduledAnnotationBeanPostProcessor类的源码：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

其中setScheduler方法的作用就是设置定时任务线程池，而Spring Boot默认使用单线程去执行定时任务，线程一直在task01的while中循环，没有多余的线程去执行task02。

配置定时任务线程池

配置定时任务线程池的方式有两种，第一种是在application.yml中配置线程池：

在application.yml中增加定时任务线程池配置：

spring:
profiles:</p><h1>指定使用的配置文件</h1><pre class="brush:php;toolbar:false;"><code>active: test

登录后复制

task: scheduling: pool: size: 5

重新启动应用：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）

根据控制台的打印可以看出，task01和task02都执行了。

第二种方式是通过编写配置类ScheduleConfig实现自定义定时任务的线程池：

新增config包，在config包下新增配置类ScheduleConfig：

@Configuration
public class ScheduleConfig {
@Bean
public TaskScheduler taskScheduler() {
ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
taskScheduler.setPoolSize(5);
return taskScheduler;
}
}

登录后复制

注释掉application.yml中的线程池大小配置，重新启动应用：

你有没有掉进去过这些Spring Boot中的“陷阱“（上）