SpringBoot无法从.env.properties读取邮件配置属性问题

我使用.env.properties存储数据库、邮件凭证等敏感数据，Spring可以正常读取数据库相关配置，但解析邮件配置时抛出占位符无法解析的错误。直接在application.properties中填写邮件信息时，应用能正常运行。

.env.properties 内容 #

DB_HOST=jdbc:mysql://localhost:3306/randomDbName
DB_USER=root
DB_PASSWORD=root

MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=25
MAIL_USER=randomUser
MAIL_PASSWORD=randomPassword
MAIL_PROTOCOL=smtp

application.properties 内容 #

# 从.env加载配置
spring.config.import=file:.env.properties

### 邮件配置 ###
spring.mail.host=${MAIL_HOST}
spring.mail.port=${MAIL_PORT}
spring.mail.username=${MAIL_USER}
spring.mail.password=${MAIL_PASSWORD}
spring.mail.protocol=${MAIL_PROTOCOL}

### 数据库配置 ###
spring.datasource.url=${DB_HOST}
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASSWORD}
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

### JWT配置 ###
jwt.expiration.time=3600000

报错信息 #

Could not resolve placeholder 'MAIL_HOST' in value "${MAIL_HOST}"

数据库凭证能正常解析，不清楚为何邮件配置会出现这个问题。

邮件服务实现代码 #

@Service
public class MailServiceImpl implements MailService {

    private final JavaMailSender javaMailSender;

    public MailServiceImpl(JavaMailSender javaMailSender) {
        this.javaMailSender = javaMailSender;
    }

    @Override
    public void send(Notification notification) {

        MimeMessagePreparator mimeMessagePreparator = mimeMessage -> {
            MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage);
            messageHelper.setFrom("email@domain.com");
            messageHelper.setTo(notification.getRecipient());
            messageHelper.setSubject(notification.getSubject());
            messageHelper.setText(notification.getContent());
        };

        javaMailSender.send(mimeMessagePreparator);
    }
}

已添加的依赖 #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

1. 调整外部配置的加载方式 #

Spring Boot的自动配置类（比如邮件自动配置）加载优先级可能高于spring.config.import引入的外部文件，导致占位符解析时.env中的属性还未加载。可以修改spring.config.import的写法，加上optional:确保加载：

spring.config.import=optional:file:.env.properties

或者将.env.properties重命名为application-env.properties，然后在application.properties中激活这个profile：

spring.profiles.active=env

2. 手动绑定邮件配置 #

绕开Spring自动配置的占位符解析，手动创建邮件配置类读取.env中的属性：

@Configuration
@PropertySource("file:.env.properties")
public class MailConfig {

    @Value("${MAIL_HOST}")
    private String mailHost;

    @Value("${MAIL_PORT}")
    private int mailPort;

    @Value("${MAIL_USER}")
    private String mailUser;

    @Value("${MAIL_PASSWORD}")
    private String mailPassword;

    @Value("${MAIL_PROTOCOL}")
    private String mailProtocol;

    @Bean
    public JavaMailSender javaMailSender() {
        JavaMailSenderImpl mailSender = new JavaMailSenderImpl();
        mailSender.setHost(mailHost);
        mailSender.setPort(mailPort);
        mailSender.setUsername(mailUser);
        mailSender.setPassword(mailPassword);
        mailSender.setProtocol(mailProtocol);

        Properties props = mailSender.getJavaMailProperties();
        props.put("mail.transport.protocol", mailProtocol);
        props.put("mail.smtp.auth", "true");
        // 根据需要添加其他邮件配置，比如SSL、调试模式等

        return mailSender;
    }
}

3. 检查配置键的拼写与大小写 #

确认.env.properties中的键名（比如MAIL_HOST）和application.properties中的占位符完全一致，Spring默认对占位符大小写敏感，不要出现拼写错误。

4. 升级Spring Boot版本 #

部分旧版本的Spring Boot在处理外部配置加载顺序上存在bug，尝试升级到2.7.x或3.x的稳定版本，能解决不少配置加载的兼容性问题。

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