12個(gè)SpringBoot配置文件的實(shí)用技巧分享
更新時(shí)間：2025年05月12日 08:17:30 作者：風(fēng)象南
配置文件是SpringBoot應(yīng)用的核心組成部分,它決定了應(yīng)用的行為、連接參數(shù)以及功能特性,本文為大家整理了12個(gè)SpringBoot配置文件的實(shí)用技巧,有需要的可以了解下
配置文件是SpringBoot應(yīng)用的核心組成部分，它決定了應(yīng)用的行為、連接參數(shù)以及功能特性。
合理利用SpringBoot的配置機(jī)制，不僅可以提高開發(fā)效率，還能增強(qiáng)應(yīng)用的靈活性和可維護(hù)性。
1. 多環(huán)境配置（Profiles）
SpringBoot支持通過profiles實(shí)現(xiàn)多環(huán)境配置，便于在開發(fā)、測試和生產(chǎn)環(huán)境之間無縫切換。
基本用法
創(chuàng)建特定環(huán)境的配置文件：
• application-dev.yml（開發(fā)環(huán)境）
• application-test.yml（測試環(huán)境）
• application-prod.yml（生產(chǎn)環(huán)境）
在主配置文件application.yml中激活特定環(huán)境：
spring:
profiles:
active: dev高級配置
使用分組功能（Spring Boot 2.4+）來簡化環(huán)境配置：
spring:
profiles:
group:
dev: local-db, local-cache, dev-api
prod: cloud-db, redis-cache, prod-api命令行激活
無需修改配置文件，直接在啟動(dòng)時(shí)指定環(huán)境：
java -jar app.jar --spring.profiles.active=prod
2. 配置屬性的優(yōu)先級
了解SpringBoot配置的優(yōu)先級順序，有助于解決配置沖突。
常見配置源優(yōu)先級（從高到低）：
1. 命令行參數(shù)
2. Java系統(tǒng)屬性（System.getProperties()）
3. 操作系統(tǒng)環(huán)境變量
4. 特定profile的配置文件
5. 應(yīng)用程序外部的application.properties/yml
6. 應(yīng)用程序內(nèi)部的application.properties/yml
應(yīng)用示例
對于數(shù)據(jù)庫URL配置，可以在不同級別設(shè)置：
# application.yml (優(yōu)先級低)
spring:
datasource:
url: jdbc:mysql://localhost:3306/default_db# 命令行參數(shù) (優(yōu)先級高) java -jar app.jar --spring.datasource.url=jdbc:mysql://prod-server:3306/prod_db
最終生效的是命令行參數(shù)中的URL。
3. 松散綁定（Relaxed Binding）
SpringBoot支持多種屬性命名風(fēng)格，自動(dòng)進(jìn)行松散綁定，提高配置的靈活性。
支持的命名風(fēng)格
對于Java屬性serverPort：
• kebab-case：server-port（推薦用于.properties和.yml文件）
• 駝峰式：serverPort
• 下劃線：server_port（推薦用于環(huán)境變量）
• 全大寫下劃線：SERVER_PORT（環(huán)境變量的標(biāo)準(zhǔn)格式）
綁定示例
配置文件：
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會自動(dòng)將connection-timeout綁定到connectionTimeout屬性。
4. 配置隨機(jī)值
在開發(fā)和測試環(huán)境中，經(jīng)常需要生成隨機(jī)值，SpringBoot提供了內(nèi)置支持。
常用隨機(jī)屬性
app:
# 隨機(jī)整數(shù)
random-int: ${random.int}
# 范圍內(nèi)的隨機(jī)整數(shù)
random-int-range: ${random.int[1000,2000]}
# 隨機(jī)長整數(shù)
random-long: ${random.long}
# 隨機(jī)字符串
random-string: ${random.uuid}
# 隨機(jī)字節(jié)
secret-key: ${random.bytes[16]}應(yīng)用場景
服務(wù)器端口隨機(jī)分配，避免開發(fā)環(huán)境端口沖突：
server:
port: ${random.int[8000,9000]}測試環(huán)境使用隨機(jī)密鑰：
app:
security:
secret-key: ${random.uuid}5. 類型安全的配置屬性（@ConfigurationProperties）
使用@ConfigurationProperties綁定結(jié)構(gòu)化配置，提供類型安全和代碼自動(dòng)完成。
基本用法
配置類：
@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
集合與復(fù)雜類型
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. 導(dǎo)入其他配置文件
在大型項(xiàng)目中，將配置拆分為多個(gè)文件可以提高可維護(hù)性。
使用@PropertySource
@Configuration
@PropertySource("classpath:db.properties")
@PropertySource("classpath:cache.properties")
public class AppConfig {
// ...
}使用spring.config.import
在Spring Boot 2.4+中，可以在主配置文件中導(dǎo)入其他配置：
spring:
config:
import:
- classpath:db.yml
- optional:file:./config/local.yml
- configserver:http://config-server:8888/注意optional:前綴表示文件不存在也不會報(bào)錯(cuò)。
7. 敏感配置的加密與保護(hù)
在生產(chǎn)環(huán)境中，保護(hù)敏感配置如密碼和API密鑰至關(guān)重要。
使用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
使用環(huán)境變量存儲敏感信息
spring:
datasource:
username: ${DB_USERNAME}
password: ${DB_PASSWORD}8. 配置屬性校驗(yàn)
對配置屬性進(jìn)行校驗(yàn)，避免不合法的配置導(dǎo)致運(yùn)行時(shí)錯(cuò)誤。
使用JSR-303校驗(yàn)
@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
}自定義校驗(yàn)
@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. 配置中使用占位符
在配置文件中使用占位符引用其他配置項(xiàng)，提高靈活性和減少重復(fù)。
基本用法
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默認(rèn)值
提供默認(rèn)值以防配置缺失：
app:
cache-dir: ${CACHE_DIR:/tmp/cache}
max-threads: ${MAX_THREADS:10}系統(tǒng)屬性和環(huán)境變量引用
server:
port: ${PORT:8080}
address: ${SERVER_ADDRESS:0.0.0.0}
logging:
path: ${LOG_PATH:${user.home}/logs}10. 配置條件化加載
使用Spring的條件注解根據(jù)條件加載配置，提高靈活性。
使用@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相關(guān)配置
}11. 列表和Map配置技巧
在配置文件中有效地表示復(fù)雜數(shù)據(jù)結(jié)構(gòu)。
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
# 復(fù)雜映射
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配置元數(shù)據(jù)
創(chuàng)建配置元數(shù)據(jù)，提供IDE自動(dòng)完成和文檔。
添加元數(shù)據(jù)依賴
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>配置類添加文檔
@ConfigurationProperties(prefix = "acme")
public class AcmeProperties {
/**
* 是否啟用ACME服務(wù)。
*/
private boolean enabled = false;
/**
* 服務(wù)的遠(yuǎn)程地址。
*/
@NotEmpty
private String remoteAddress;
/**
* 會話超時(shí)時(shí)間，單位為秒。
* 最小值為1分鐘，最大值為1小時(shí)。
*/
@Min(60)
@Max(3600)
private int sessionTimeout = 600;
// getters和setters
}自定義元數(shù)據(jù)
創(chuàng)建META-INF/additional-spring-configuration-metadata.json文件：
{
"properties": [
{
"name": "app.security.api-key",
"type": "java.lang.String",
"description": "API安全密鑰，用于外部服務(wù)認(rèn)證。",
"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速率限制配置已移動(dòng)到security命名空間。"
}
}
],
"hints": [
{
"name": "app.log-level",
"values": [
{
"value": "debug",
"description": "調(diào)試日志級別。"
},
{
"value": "info",
"description": "信息日志級別。"
},
{
"value": "warn",
"description": "警告日志級別。"
},
{
"value": "error",
"description": "錯(cuò)誤日志級別。"
}
]
}
]
}總結(jié)
在實(shí)際開發(fā)中，我們應(yīng)根據(jù)項(xiàng)目規(guī)模和復(fù)雜度選擇合適的配置策略。
通過合理應(yīng)用這些技巧，我們可以構(gòu)建更加靈活、安全且易于維護(hù)的SpringBoot應(yīng)用，為業(yè)務(wù)需求的快速變化提供堅(jiān)實(shí)的技術(shù)支持。
到此這篇關(guān)于12個(gè)SpringBoot配置文件的實(shí)用技巧分享的文章就介紹到這了,更多相關(guān)SpringBoot配置文件實(shí)用技巧內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
java多線程開發(fā)時(shí)，常常用到線程池技術(shù)，這篇文章是對創(chuàng)建java線程池時(shí)的七個(gè)參數(shù)的詳細(xì)解釋，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2022-03-03
這篇文章主要為大家詳細(xì)介紹了23種設(shè)計(jì)模式之java中介者模式，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2018-01-01
mybatis多表查詢的實(shí)現(xiàn)(xml方式)
本文主要介紹了mybatis多表查詢的實(shí)現(xiàn)(xml方式)，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2022-03-03
Spring boot定時(shí)任務(wù)的原理及動(dòng)態(tài)創(chuàng)建詳解
這篇文章主要給大家介紹了關(guān)于Spring boot定時(shí)任務(wù)的原理及動(dòng)態(tài)創(chuàng)建的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧2019-03-03
本文主要介紹了IDEA無法使用Git?Pull的問題，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-02-02
SpringMVC實(shí)現(xiàn)獲取請求參數(shù)方法詳解
Spring MVC 是 Spring 提供的一個(gè)基于 MVC 設(shè)計(jì)模式的輕量級 Web 開發(fā)框架，本質(zhì)上相當(dāng)于 Servlet，Spring MVC 角色劃分清晰，分工明細(xì)，這篇文章主要介紹了SpringMVC實(shí)現(xiàn)獲取請求參數(shù)方法2022-09-09
今天帶大家分析java攔截器和過濾器的區(qū)別,文中有非常詳細(xì)的解釋說明,對正在學(xué)習(xí)java的小伙伴們有很好的幫助,需要的朋友可以參考下2021-05-05
springboot一個(gè)自定義注解如何搞定多線程事務(wù)
文章介紹了Spring?Boot中使用`@Async`注解進(jìn)行聲明式多線程編程的方法,以及如何通過自定義注解和AOP實(shí)現(xiàn)多線程事務(wù)控制,同時(shí),還解釋了`CountDownLatch`的使用場景及其工作原理2024-12-12
這篇文章主要給大家介紹了J關(guān)于DK10新特性之本地變量類型var的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用JDK10具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧2020-05-05
微信游戲打飛機(jī)游戲制作(java模擬微信打飛機(jī)游戲)
java模擬微信打飛機(jī)游戲,大家參考使用吧2013-12-12