12个SpringBoot配置文件的实用技巧分享

更新时间：2025年05月12日 08:17:30 作者：风象南

配置文件是SpringBoot应用的核心组成部分,它决定了应用的行为、连接参数以及功能特性,本文为大家整理了12个SpringBoot配置文件的实用技巧,有需要的可以了解下

1. 多环境配置（Profiles）

SpringBoot支持通过profiles实现多环境配置，便于在开发、测试和生产环境之间无缝切换。

基本用法

创建特定环境的配置文件：

• application-dev.yml（开发环境）

• application-test.yml（测试环境）

• application-prod.yml（生产环境）

在主配置文件application.yml中激活特定环境：

spring:
  profiles:
    active: dev

高级配置

使用分组功能（Spring Boot 2.4+）来简化环境配置：

spring:
  profiles:
    group:
      dev: local-db, local-cache, dev-api
      prod: cloud-db, redis-cache, prod-api

命令行激活

无需修改配置文件，直接在启动时指定环境：

java -jar app.jar --spring.profiles.active=prod

2. 配置属性的优先级

了解SpringBoot配置的优先级顺序，有助于解决配置冲突。

常见配置源优先级（从高到低）：

1. 命令行参数

2. Java系统属性（System.getProperties()）

3. 操作系统环境变量

4. 特定profile的配置文件

5. 应用程序外部的application.properties/yml

6. 应用程序内部的application.properties/yml

应用示例

对于数据库URL配置，可以在不同级别设置：

# application.yml (优先级低)
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/default_db

# 命令行参数 (优先级高)
java -jar app.jar --spring.datasource.url=jdbc:mysql://prod-server:3306/prod_db

最终生效的是命令行参数中的URL。

3. 松散绑定（Relaxed Binding）

SpringBoot支持多种属性命名风格，自动进行松散绑定，提高配置的灵活性。

支持的命名风格

对于Java属性serverPort：

• kebab-case：server-port（推荐用于.properties和.yml文件）

• 驼峰式：serverPort

• 下划线：server_port（推荐用于环境变量）

• 全大写下划线：SERVER_PORT（环境变量的标准格式）

绑定示例

配置文件：

my-app:
  connection-timeout: 5000
  read-timeout: 10000

Java代码：

@ConfigurationProperties(prefix = "my-app")
public class AppProperties {
    private int connectionTimeout;
    private int readTimeout;
    
    // getters and setters
}

SpringBoot会自动将connection-timeout绑定到connectionTimeout属性。

4. 配置随机值

在开发和测试环境中，经常需要生成随机值，SpringBoot提供了内置支持。

常用随机属性

app:
  # 随机整数
  random-int: ${random.int}
  # 范围内的随机整数
  random-int-range: ${random.int[1000,2000]}
  # 随机长整数
  random-long: ${random.long}
  # 随机字符串
  random-string: ${random.uuid}
  # 随机字节
  secret-key: ${random.bytes[16]}

应用场景

服务器端口随机分配，避免开发环境端口冲突：

server:
  port: ${random.int[8000,9000]}

测试环境使用随机密钥：

app:
  security:
    secret-key: ${random.uuid}

5. 类型安全的配置属性（@ConfigurationProperties）

使用@ConfigurationProperties绑定结构化配置，提供类型安全和代码自动完成。

基本用法

配置类：

@Component
@ConfigurationProperties(prefix = "mail")
@Validated
public class MailProperties {
    
    @NotEmpty
    private String host;
    
    @Min(1025)
    @Max(65536)
    private int port = 25;
    
    @Email
    private String from;
    
    private boolean enabled;
    
    // getters and setters
}

配置文件：

mail:
  host: smtp.example.com
  port: 587
  from: noreply@example.com
  enabled: true

集合与复杂类型

mail:
  recipients:
    - admin@example.com
    - support@example.com
  connection:
    timeout: 5000
    retry: 3
  additional-headers:
    X-Priority: 1
    X-Mailer: MyApp

@ConfigurationProperties(prefix = "mail")
public class MailProperties {
    private List<String> recipients = new ArrayList<>();
    private Connection connection = new Connection();
    private Map<String, String> additionalHeaders = new HashMap<>();
    
    // getters and setters
    
    public static class Connection {
        private int timeout;
        private int retry;
        
        // getters and setters
    }
}

6. 导入其他配置文件

在大型项目中，将配置拆分为多个文件可以提高可维护性。

使用@PropertySource

@Configuration
@PropertySource("classpath:db.properties")
@PropertySource("classpath:cache.properties")
public class AppConfig {
    // ...
}

使用spring.config.import

在Spring Boot 2.4+中，可以在主配置文件中导入其他配置：

spring:
  config:
    import:
      - classpath:db.yml
      - optional:file:./config/local.yml
      - configserver:http://config-server:8888/

注意optional:前缀表示文件不存在也不会报错。

7. 敏感配置的加密与保护

在生产环境中，保护敏感配置如密码和API密钥至关重要。

使用Jasypt加密

1. 添加Jasypt依赖：

<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
    <version>3.0.4</version>
</dependency>

2. 加密配置值：

# 加密后的配置
spring.datasource.password=ENC(G8Sn36MAJOWJwEgAMZM3Cw0QC9rEEVyn)

3. 提供解密密钥：

java -jar app.jar --jasypt.encryptor.password=mySecretKey

使用环境变量存储敏感信息

spring:
  datasource:
    username: ${DB_USERNAME}
    password: ${DB_PASSWORD}

8. 配置属性校验

对配置属性进行校验，避免不合法的配置导致运行时错误。

使用JSR-303校验

@ConfigurationProperties(prefix = "app.connection")
@Validated
public class ConnectionProperties {
    
    @NotNull
    @Min(1000)
    @Max(10000)
    private Integer timeout;
    
    @Pattern(regexp = "^(http|https)://.*$")
    private String serviceUrl;
    
    @Email
    private String supportEmail;
    
    // getters and setters
}

自定义校验

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = IpAddressValidator.class)
public @interface IpAddress {
    String message() default "Invalid IP address";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

public class IpAddressValidator implements ConstraintValidator<IpAddress, String> {
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null) {
            return true;
        }
        String regex = "^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$";
        return value.matches(regex);
    }
}

@ConfigurationProperties(prefix = "app.server")
@Validated
public class ServerProperties {
    @IpAddress
    private String ipAddress;
    // ...
}

9. 配置中使用占位符

在配置文件中使用占位符引用其他配置项，提高灵活性和减少重复。

基本用法

app:
  name: MyApp
  api:
    base-url: http://api.example.com
    version: v1
    full-url: ${app.api.base-url}/${app.api.version}
  security:
    timeout: 3600
    timeout-millis: ${app.security.timeout}000

默认值

提供默认值以防配置缺失：

app:
  cache-dir: ${CACHE_DIR:/tmp/cache}
  max-threads: ${MAX_THREADS:10}

系统属性和环境变量引用

server:
  port: ${PORT:8080}
  address: ${SERVER_ADDRESS:0.0.0.0}
  
logging:
  path: ${LOG_PATH:${user.home}/logs}

10. 配置条件化加载

使用Spring的条件注解根据条件加载配置，提高灵活性。

使用@Profile

@Configuration
@Profile("dev")
public class DevDatabaseConfig {
    @Bean
    public DataSource dataSource() {
        return new EmbeddedDatabaseBuilder()
            .setType(EmbeddedDatabaseType.H2)
            .build();
    }
}

@Configuration
@Profile("prod")
public class ProdDatabaseConfig {
    @Bean
    public DataSource dataSource() {
        HikariDataSource dataSource = new HikariDataSource();
        dataSource.setJdbcUrl("jdbc:mysql://prod-db:3306/app");
        // 其他配置...
        return dataSource;
    }
}

使用@Conditional

@Configuration
@ConditionalOnProperty(name = "app.cache.enabled", havingValue = "true")
public class CacheConfig {
    @Bean
    public CacheManager cacheManager() {
        return new ConcurrentMapCacheManager();
    }
}

@Configuration
@ConditionalOnMissingBean(CacheManager.class)
public class NoCacheConfig {
    // 备用配置
}

基于类路径条件

@Configuration
@ConditionalOnClass(name = "org.springframework.data.redis.core.RedisTemplate")
public class RedisConfig {
    // Redis相关配置
}

11. 列表和Map配置技巧

在配置文件中有效地表示复杂数据结构。

YAML中的列表

app:
  # 简单列表
  servers:
    - server1.example.com
    - server2.example.com
    - server3.example.com
  
  # 对象列表
  endpoints:
    - name: users
      url: /api/users
      method: GET
    - name: orders
      url: /api/orders
      method: POST

在Java中绑定：

@ConfigurationProperties(prefix = "app")
public class AppConfig {
    private List<String> servers = new ArrayList<>();
    private List<Endpoint> endpoints = new ArrayList<>();
    
    // getters and setters
    
    public static class Endpoint {
        private String name;
        private String url;
        private String method;
        
        // getters and setters
    }
}

Map配置

app:
  # 简单映射
  feature-flags:
    enableNewUI: true
    enableAnalytics: false
    enableNotifications: true

  # 复杂映射
  datasources:
    main:
      url: jdbc:mysql://main-db:3306/app
      username: mainuser
      maxPoolSize: 20
    report:
      url: jdbc:mysql://report-db:3306/reports
      username: reportuser
      maxPoolSize: 5

在Java中绑定：

@ConfigurationProperties(prefix = "app")
public class AppConfig {
    private Map<String, Boolean> featureFlags = new HashMap<>();
    private Map<String, DataSourceProperties> datasources = new HashMap<>();
    
    // getters and setters
    
    public static class DataSourceProperties {
        private String url;
        private String username;
        private int maxPoolSize;
        
        // getters and setters
    }
}

12. 使用Spring Boot配置元数据

创建配置元数据，提供IDE自动完成和文档。

添加元数据依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

配置类添加文档

@ConfigurationProperties(prefix = "acme")
public class AcmeProperties {

    /**
     * 是否启用ACME服务。
     */
    private boolean enabled = false;

    /**
     * 服务的远程地址。
     */
    @NotEmpty
    private String remoteAddress;

    /**
     * 会话超时时间，单位为秒。
     * 最小值为1分钟，最大值为1小时。
     */
    @Min(60)
    @Max(3600)
    private int sessionTimeout = 600;

    // getters和setters
}

自定义元数据

创建META-INF/additional-spring-configuration-metadata.json文件：

{
  "properties": [
    {
      "name": "app.security.api-key",
      "type": "java.lang.String",
      "description": "API安全密钥，用于外部服务认证。",
      "sourceType": "com.example.AppSecurityProperties"
    },
    {
      "name": "app.rate-limit.enabled",
      "type": "java.lang.Boolean",
      "description": "是否启用API速率限制。",
      "defaultValue": true,
      "deprecation": {
        "level": "warning",
        "replacement": "app.security.rate-limit.enabled",
        "reason": "API速率限制配置已移动到security命名空间。"
      }
    }
  ],
  "hints": [
    {
      "name": "app.log-level",
      "values": [
        {
          "value": "debug",
          "description": "调试日志级别。"
        },
        {
          "value": "info",
          "description": "信息日志级别。"
        },
        {
          "value": "warn",
          "description": "警告日志级别。"
        },
        {
          "value": "error",
          "description": "错误日志级别。"
        }
      ]
    }
  ]
}

总结

在实际开发中，我们应根据项目规模和复杂度选择合适的配置策略。

通过合理应用这些技巧，我们可以构建更加灵活、安全且易于维护的SpringBoot应用，为业务需求的快速变化提供坚实的技术支持。

到此这篇关于12个SpringBoot配置文件的实用技巧分享的文章就介绍到这了,更多相关SpringBoot配置文件实用技巧内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

java冒泡排序和选择排序详解
这篇文章主要介绍了java数组算法例题代码详解(冒泡排序,选择排序),本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2021-07-07
SpringBoot中@Scheduled()注解以及cron表达式详解
这篇文章主要介绍了SpringBoot中@Scheduled()注解以及cron表达式详解,@Scheduled注解是Spring Boot提供的用于定时任务控制的注解，主要用于控制任务在某个指定时间执行，或者每隔一段时间执行,需要的朋友可以参考下
2023-08-08
java虚拟机钩子关闭函数addShutdownHook的操作
这篇文章主要介绍了java虚拟机钩子关闭函数addShutdownHook的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-02-02
kkFileView启动报错:报错2003端口占用的问题及解决
kkFileView启动报错因office组件2003端口未关闭,解决：查杀占用端口的进程,终止Java进程,使用shutdown.sh脚本优雅关闭,再通过startup.sh或jar命令重启
2025-07-07
Java 读取文件方法大全
这篇文章主要介绍了Java 读取文件方法大全,需要的朋友可以参考下
2014-11-11
java实现输出文件夹下某个格式的所有文件实例代码
这篇文章主要介绍了java实现输出文件夹下某个格式的所有文件,本文给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下
2018-06-06
Java String对象使用方法详解
这篇文章主要介绍了Java String对象使用方法详解的相关资料,需要的朋友可以参考下
2017-04-04
Spring循环依赖产生与解决
Spring的解决循环依赖是有前置条件的，要解决循环依赖我们首先要了解Spring Bean对象的创建过程和依赖注入的方式。依赖注入方式，我之前的博客有所分享，大家可以在看本篇文章之前进行一下小小的回顾
2022-12-12
Java 中 synchronized的用法详解(四种用法)
Java语言的关键字，当它用来修饰一个方法或者一个代码块的时候，能够保证在同一时刻最多只有一个线程执行该段代码。本文给大家介绍java中 synchronized的用法，对本文感兴趣的朋友一起看看吧
2015-11-11
Java Unsafe 类的讲解
这篇文章主要给大家分享了 Java Unsafe 类的讲解，文章围绕Unsafe 类的相关资料展开详细内容,具有一定的参考价值需要的朋友可以参考一下
2021-11-11

12个SpringBoot配置文件的实用技巧分享

目录

1. 多环境配置（Profiles）

基本用法

高级配置

命令行激活

2. 配置属性的优先级

常见配置源优先级（从高到低）：

应用示例

3. 松散绑定（Relaxed Binding）

支持的命名风格

绑定示例

4. 配置随机值

常用随机属性

应用场景

5. 类型安全的配置属性（@ConfigurationProperties）

基本用法

集合与复杂类型

6. 导入其他配置文件

使用@PropertySource

使用spring.config.import

7. 敏感配置的加密与保护

使用Jasypt加密

使用环境变量存储敏感信息

8. 配置属性校验

使用JSR-303校验

自定义校验

9. 配置中使用占位符

基本用法

默认值

系统属性和环境变量引用

10. 配置条件化加载

使用@Profile

使用@Conditional

基于类路径条件

11. 列表和Map配置技巧

YAML中的列表

Map配置

12. 使用Spring Boot配置元数据

添加元数据依赖

配置类添加文档

自定义元数据

总结

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具