Spring 加載 Properties 配置文件最佳實踐：@Value、PropertyPlaceholderConfigurer、PropertySource 完全指南

Spring 提供多種方式加載 .properties 配置並注入 Bean。本文對比 PropertyPlaceholderConfigurer、PropertySourcesPlaceholderConfigurer、@PropertySource、@Value、Environment、@ConfigurationProperties 等方案，給出生產環境推薦配置模式。

核心配置文件 jdbc.properties

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=secret123

方案一：XML 配置 PropertyPlaceholderConfigurer (Spring 經典)

<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
  <property name="locations">
    <list><value>classpath:jdbc.properties</value></list>
  </property>
  <property name="fileEncoding" value="UTF-8"/>
  <property name="ignoreUnresolvablePlaceholders" value="true"/>
  <property name="systemPropertiesModeName" value="SYSTEM_PROPERTIES_MODE_OVERRIDE"/>
</bean>

用法：${jdbc.url} 占位符注入 XML Bean 屬性或 @Value("${jdbc.url}") 注入字段。

方案二：@PropertySource + Environment (Java Config 推薦)

@Configuration
@PropertySource("classpath:jdbc.properties")
public class DataSourceConfig {
    @Autowired Environment env;

    @Bean
    public DataSource dataSource() {
        HikariDataSource ds = new HikariDataSource();
        ds.setDriverClassName(env.getProperty("jdbc.driver"));
        ds.setJdbcUrl(env.getProperty("jdbc.url"));
        ds.setUsername(env.getProperty("jdbc.username"));
        ds.setPassword(env.getProperty("jdbc.password"));
        return ds;
    }
}

方案三：@ConfigurationProperties 類型安全綁定 (Spring Boot 風格，強烈推薦)

@Component
@ConfigurationProperties(prefix = "jdbc")
@PropertySource("classpath:jdbc.properties") // Spring Boot 自動加載 application.properties 可省略
public class JdbcProperties {
    private String driver;
    private String url;
    private String username;
    private String password;
    // getter/setter
}

啟用：@EnableConfigurationProperties(JdbcProperties.class) 或掃描 @Component。

優點：類型安全、IDE 提示、鬆散綁定 (driver-class-name ↔ driverClassName)、驗證 (JSR-303)。

方案四：PropertiesFactoryBean 暴露 Properties 對象

<bean id="configProperties" class="org.springframework.beans.factory.config.PropertiesFactoryBean">
  <property name="locations">
    <list><value>classpath:jdbc.properties</value></list>
  </property>
  <property name="fileEncoding" value="UTF-8"/>
</bean>

<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertySourcesPlaceholderConfigurer">
  <property name="properties" ref="configProperties"/>
</bean>

注入用法：

@Value("#{configProperties['jdbc.url']}")
private String url;

@Value("#{configProperties['jdbc.username']}")
private String username;

注意：PropertySourcesPlaceholderConfigurer 是 4.3+ 推薦替代 PropertyPlaceholderConfigurer，支援 Spring Environment 抽象與 Profile。

單元測試驗證

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = AppConfig.class) // 或 locations
public class PropertiesTest {
    @Autowired JdbcProperties jdbcProperties; // 方案三
    @Value("${jdbc.url}") String url; // 方案一/二

    @Test
    public void test() {
        assertEquals("jdbc:mysql://...", jdbcProperties.getUrl());
        assertEquals("jdbc:mysql://...", url);
    }
}

核心類對比

最佳實踐建議

1. Spring Boot 專案：直接用 application.yml/properties + @ConfigurationProperties，零配置。
2. 傳統 Spring XML：PropertySourcesPlaceholderConfigurer + @Value("${key}")。
3. 傳統 Spring Java Config：@PropertySource + Environment 或 @ConfigurationProperties。
4. 敏感信息：密碼等勿明文，使用 jasypt-spring-boot 加密或外部配置中心 (Nacos/Apollo/Consul)。
5. 多環境隔離：jdbc-dev.properties, jdbc-prod.properties + @Profile 或 Spring Boot application-{profile}.yml。

配置管理是應用可維護性的關鍵。統一用 @ConfigurationProperties 綁定強類型配置對象，配合 @PropertySource 聲明源，PropertySourcesPlaceholderConfigurer 解析占位符，構建清晰、安全、可測試的配置體系。