如何用外部.jar覆盖Thymeleaf模板且无需重新打包应用？

一、配置Thymeleaf模板加载优先级 #

通过自定义模板解析器，让外部Jar中的模板拥有更高加载优先级，找不到时自动回退到主应用模板：

@Configuration
public class ThymeleafConfig {

    @Bean
    public ITemplateResolver externalJarTemplateResolver(ClassLoader classLoader) {
        ClassLoaderTemplateResolver resolver = new ClassLoaderTemplateResolver(classLoader);
        resolver.setPrefix("templates/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCharacterEncoding("UTF-8");
        resolver.setOrder(0); // 优先级高于主应用默认解析器
        resolver.setCheckExistence(true); // 检查模板是否存在，不存在则使用主应用模板
        return resolver;
    }
}

二、外部Jar结构规范 #

• 模板目录结构与主应用保持一致：主应用模板在src/main/resources/templates/下，外部Jar需将待覆盖/新增的模板放在resources/templates/对应路径下（比如要覆盖index.html，就放resources/templates/index.html）。
• 新增功能代码（如Controller、业务逻辑）直接打包进Jar，无需特殊结构。

三、部署执行方式 #

无需重新打包主应用，直接将外部Jar加入类路径启动：

• 普通Java应用启动命令：

java -cp 主应用.jar:外部功能.jar com.example.MainApplication

• Spring Boot应用启动命令（支持自动加载外部Jar）：

java -jar 主应用.jar --loader.path=外部功能.jar,lib/

四、路由覆盖与新增 #

• 新增路由：外部Jar中的Controller直接定义新的@GetMapping/@PostMapping路径即可生效。
• 覆盖路由：对于相同路径的路由，确保外部Jar的Controller优先加载，或使用更具体的路径匹配；若基于接口实现，可给外部实现类添加@Primary注解抢占优先级。

示例外部Controller：

@Controller
public class ExternalIndexController {

    @GetMapping("/")
    public String index(Model model) {
        model.addAttribute("message", "外部Jar提供的内容");
        return "index"; // 调用外部Jar中的模板
    }
}

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