如何在Quarkus运行时修改MailConfig邮件配置并支持从数据库加载

默认注入的@Inject Mailer是读取静态application.properties配置生成的单例，无法动态更新，因此需要通过Quarkus提供的Mailer可编程API自定义构造逻辑，实现从数据库读配置和运行时刷新：

• 第一步：引入依赖
  除了基础的quarkus-mailer依赖外，还需要引入你项目用到的数据库持久化依赖（如quarkus-hibernate-orm-panache、JDBC驱动等），如果需要缓存邮件配置减少查库频率，可额外引入quarkus-cache依赖。

• 第二步：创建数据库存储的邮件配置实体
  你需要在数据库中存储所有Mailer相关的配置项，示例用Panache实体代码如下：

@Entity
public class MailSetting extends PanacheEntity {
    // SMTP服务器地址
    public String smtpHost;
    // SMTP端口
    public Integer smtpPort;
    // 发件人账号
    public String smtpUsername;
    // 发件人授权码/密码
    public String smtpPassword;
    // 是否开启SSL
    public Boolean enableSsl;
    // 默认发件人地址
    public String defaultFrom;
    // 标识当前是否为生效配置
    public Boolean active;
}

• 第三步：封装动态Mailer服务类
  自定义服务类实现从数据库读配置、构造Mailer实例、缓存配置、刷新配置的逻辑：

@ApplicationScoped
public class DynamicMailerService {

    // 缓存生效的邮件配置，避免每次发邮件查库，缓存失效后自动拉取最新配置
    @CacheResult(cacheName = "mailSettingCache")
    public MailSetting getActiveMailSetting() {
        return MailSetting.find("active", true).firstResult();
    }

    // 用最新配置构造Mailer实例
    public Mailer buildDynamicMailer() {
        MailSetting currentSetting = getActiveMailSetting();
        return Mailer.builder()
                .host(currentSetting.smtpHost)
                .port(currentSetting.smtpPort)
                .username(currentSetting.smtpUsername)
                .password(currentSetting.smtpPassword)
                .ssl(currentSetting.enableSsl)
                .from(currentSetting.defaultFrom)
                .build();
    }

    // 封装发邮件的业务方法，业务代码直接调用这个方法即可
    public void sendTextMail(String toAddress, String subject, String content) {
        Mailer dynamicMailer = buildDynamicMailer();
        dynamicMailer.send(Mail.withText(toAddress, subject, content));
    }

    // 修改数据库配置后调用此方法，主动清空缓存立刻生效新配置
    @CacheInvalidate(cacheName = "mailSettingCache")
    public void refreshMailConfig() {
        // 仅触发缓存失效，无需额外业务逻辑
    }
}

• 第四步：实现运行时配置生效
  你修改数据库中active为true的配置项字段之后，调用refreshMailConfig()方法清空配置缓存，后续发送邮件就会使用新的配置构造Mailer实例，无需重启应用。

注意：如果你的应用发邮件并发量很低，也可以去掉缓存相关注解，每次构造Mailer前实时查询数据库获取最新配置，不需要手动调用刷新方法即可实时生效。如果需要支持多套邮件配置切换，只需要修改getActiveMailSetting()方法的查询逻辑即可。

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