Spring Boot从数据库实现国际化最佳实践咨询

核心思路是扩展Spring原生的MessageSource接口，用自定义的数据库实现替换默认的ResourceBundleMessageSource，这样现有业务代码完全不用改——原来依赖MessageSource的地方可以直接复用，只需要新增数据库相关的实体、查询逻辑和配置类。

步骤1：定义数据库实体与查询接口 #

首先新增本地化消息对应的实体类（完全不影响现有实体），对应数据库主表：

@Entity
@Table(name = "localized_messages")
// 给code+locale加联合唯一索引，避免重复数据
@TableIndex(name = "idx_code_locale", columnList = "code, locale", unique = true)
public class LocalizedMessage {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    // 消息键，和原来properties里的key一致
    @Column(nullable = false)
    private String code;
    
    // 语言标识，比如zh_CN、en_US
    @Column(nullable = false)
    private String locale;
    
    // 本地化消息内容
    @Column(nullable = false)
    private String message;

    // 自动生成getter、setter
}

然后新增JPA Repository（用MyBatis的话换成Mapper即可）：

public interface LocalizedMessageRepository extends JpaRepository<LocalizedMessage, Long> {
    // 根据消息键和语言查询
    Optional<LocalizedMessage> findByCodeAndLocale(String code, String locale);
}

步骤2：实现自定义DatabaseMessageSource #

继承Spring的AbstractMessageSource（比直接实现MessageSource更省心，已经封装了大部分通用逻辑），重写resolveCode方法从数据库取消息，同时加入缓存避免频繁查库：

@Component
public class DatabaseMessageSource extends AbstractMessageSource {

    private final LocalizedMessageRepository messageRepository;
    // 用ConcurrentHashMap做本地缓存，key为code:locale
    private final ConcurrentHashMap<String, String> messageCache = new ConcurrentHashMap<>();

    public DatabaseMessageSource(LocalizedMessageRepository messageRepository) {
        this.messageRepository = messageRepository;
    }

    @Override
    protected MessageFormat resolveCode(String code, Locale locale) {
        String localeStr = locale.toString();
        String cacheKey = code + ":" + localeStr;

        // 优先读缓存
        String message = messageCache.get(cacheKey);
        if (message == null) {
            // 先查当前locale，找不到就 fallback 到默认locale（比如zh_CN）
            Optional<LocalizedMessage> dbMessage = messageRepository.findByCodeAndLocale(code, localeStr);
            if (dbMessage.isEmpty()) {
                dbMessage = messageRepository.findByCodeAndLocale(code, Locale.CHINA.toString());
            }
            // 找不到就返回code本身，避免空指针
            message = dbMessage.map(LocalizedMessage::getMessage).orElse(code);
            messageCache.put(cacheKey, message);
        }

        return createMessageFormat(message, locale);
    }

    // 提供缓存清除方法，用于数据库消息更新后实时生效
    public void clearCache() {
        messageCache.clear();
    }
}

步骤3：配置为默认MessageSource #

创建配置类，把自定义的DatabaseMessageSource注册为Spring容器的主messageSource Bean，替换默认的资源文件实现：

@Configuration
public class MessageConfig {

    @Bean(name = "messageSource")
    public MessageSource databaseMessageSource(LocalizedMessageRepository messageRepository) {
        DatabaseMessageSource messageSource = new DatabaseMessageSource(messageRepository);
        // 设置默认语言
        messageSource.setDefaultLocale(Locale.CHINA);
        // 找不到消息时返回code作为兜底
        messageSource.setUseCodeAsDefaultMessage(true);
        return messageSource;
    }
}

关键细节 #

1. 缓存优化：本地缓存能大幅降低数据库查询压力，如果需要分布式缓存，可以把ConcurrentHashMap换成Redis缓存，逻辑不变。
2. 数据迁移：把原来messages_xx.properties里的键值对批量导入到localized_messages表中，保证业务平滑过渡。
3. 动态更新：如果需要修改数据库消息后实时生效，可以新增一个接口调用clearCache()方法，或者监听数据库的更新事件自动清除缓存。
4. ** fallback 机制**：如果数据库中没有对应locale的消息，自动 fallback 到默认语言，避免前端显示空白。

兼容现有代码 #

原来的业务代码完全不用改，比如你之前这样调用：

@Autowired
private MessageSource messageSource;

// 获取本地化消息
String userName = messageSource.getMessage("user.name", null, LocaleContextHolder.getLocale());

现在直接复用即可，Spring会自动注入我们的DatabaseMessageSource实现。

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