Spring框架中多语言URL本地化实现方案咨询

要实现不同语言环境对应完全独立的URL（比如/en/welcome和/de/willkommen映射到同一控制器方法），并通过外部文件存储路由映射、运行时加载，可按以下步骤实现：

1. 定义本地化路由配置文件 #

创建外部配置文件（比如localized-routes.properties），按语言环境分组配置路径与控制器的映射关系：

# 英文路由
en.welcome.path=/en/welcome
en.welcome.controller=com.example.controller.HomeController
en.welcome.method=welcome

# 德文路由
de.welcome.path=/de/willkommen
de.welcome.controller=com.example.controller.HomeController
de.welcome.method=welcome

如果偏好更清晰的结构，可改用YAML格式的localized-routes.yml：

en:
  welcome:
    path: /en/welcome
    controller: com.example.controller.HomeController
    method: welcome
de:
  welcome:
    path: /de/willkommen
    controller: com.example.controller.HomeController
    method: welcome

2. 动态注册请求映射 #

通过Spring MVC核心类RequestMappingHandlerMapping，在容器初始化时加载配置文件并注册路由：

@Configuration
public class DynamicRouteConfig {

    @Autowired
    private RequestMappingHandlerMapping requestMappingHandlerMapping;

    @Value("classpath:localized-routes.properties")
    private Resource routeResource;

    @PostConstruct
    public void registerDynamicRoutes() throws Exception {
        // 加载配置文件
        Properties routesProps = new Properties();
        routesProps.load(routeResource.getInputStream());

        // 按路由名称分组，统一处理多语言映射
        Map<String, Map<String, String>> routeGroups = new HashMap<>();
        for (String key : routesProps.stringPropertyNames()) {
            String[] parts = key.split("\\.");
            if (parts.length != 3) continue;
            String locale = parts[0];
            String routeName = parts[1];
            String propKey = parts[2];

            routeGroups.computeIfAbsent(routeName, k -> new HashMap<>())
                       .put(locale + "." + propKey, routesProps.getProperty(key));
        }

        // 遍历分组，注册每个语言环境的路由
        for (Map.Entry<String, Map<String, String>> entry : routeGroups.entrySet()) {
            Map<String, String> routeProps = entry.getValue();
            // 获取控制器实例和目标方法
            String controllerBeanName = routeProps.get("en.controller");
            String methodName = routeProps.get("en.method");
            Object controller = requestMappingHandlerMapping.getApplicationContext().getBean(controllerBeanName);
            Method method = controller.getClass().getMethod(methodName);

            // 为每个语言路径注册映射
            for (String key : routeProps.keySet()) {
                if (key.endsWith(".path")) {
                    String path = routeProps.get(key);
                    // 构建RequestMappingInfo，默认支持GET请求（可按需扩展其他方法）
                    RequestMappingInfo mappingInfo = RequestMappingInfo.paths(path)
                            .methods(RequestMethod.GET)
                            .build();
                    // 注册路由
                    requestMappingHandlerMapping.registerMapping(mappingInfo, controller, method);
                }
            }
        }
    }
}

如果使用YAML配置，只需替换配置加载部分为：

YamlPropertiesFactoryBean yamlFactory = new YamlPropertiesFactoryBean();
yamlFactory.setResources(routeResource);
Properties routesProps = yamlFactory.getObject();

3. 配置Locale解析器 #

实现URL前缀式的Locale识别，从URL的第一个路径段（如en/de）解析当前语言环境：

@Configuration
public class LocaleConfig implements WebMvcConfigurer {

    @Bean
    public LocaleResolver localeResolver() {
        UrlLocaleResolver resolver = new UrlLocaleResolver();
        resolver.setDefaultLocale(Locale.ENGLISH);
        return resolver;
    }

    // 自定义URL Locale解析器
    static class UrlLocaleResolver extends AbstractLocaleResolver {
        @Override
        public Locale resolveLocale(HttpServletRequest request) {
            String[] pathSegments = request.getRequestURI().split("/");
            if (pathSegments.length > 1 && !pathSegments[1].isEmpty()) {
                try {
                    return Locale.forLanguageTag(pathSegments[1]);
                } catch (IllegalArgumentException e) {
                    // 无效语言，返回默认Locale
                    return getDefaultLocale();
                }
            }
            return getDefaultLocale();
        }

        @Override
        public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {
            throw new UnsupportedOperationException("无法通过此解析器修改Locale");
        }
    }
}

4. 编写目标控制器 #

控制器无需添加@RequestMapping注解，仅保留业务逻辑方法即可：

@Controller
public class HomeController {
    // 注入消息源，用于文本本地化（可选）
    @Autowired
    private MessageSource messageSource;

    public String welcome(Model model, Locale locale) {
        // 根据当前Locale获取本地化文本
        String welcomeMsg = messageSource.getMessage("welcome.message", null, locale);
        model.addAttribute("message", welcomeMsg);
        return "welcome"; // 返回视图名称
    }
}

注意事项 #

• 路由配置文件可放在classpath下，也可配置为外部路径，方便线上修改（只需调整@Value的资源路径）。
• 若需支持POST/PUT等请求方法，可在配置文件中新增method属性，注册时指定methods(RequestMethod.POST)等。
• 动态注册时机为@PostConstruct，确保Spring容器初始化完成后再加载路由，避免依赖问题。

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