IntelliJ无法识别Thymeleaf模板源文件夹，如何解决？

问题概述 #

项目运行完全正常，但IntelliJ持续报错：

Cannot resolve MVC view 'index'

自定义Thymeleaf配置中，SpringResourceTemplateResolver已设置前缀classpath:templates/web/，但IDE无法识别该路径映射——返回index时IDE报错，指定web/index则IDE不报错但运行时无效。已尝试设置Web资源目录、配置Spring Facet、清理缓存，均无效果。

可行解决方案 #

1. 给自定义模板解析器添加@Bean注解 #

当前代码中htmlTemplateResolver()是普通方法，未注册为Spring Bean，IntelliJ的Spring MVC视图解析器无法识别该自定义路径配置。修改代码：

@Configuration(proxyBeanMethods = false)
public class ThymeleafWebConfig implements ApplicationContextAware {

    private ApplicationContext applicationContext;

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) {
        this.applicationContext = applicationContext;
    }

    @Bean
    public SpringTemplateEngine templateEngine(MessageSource htmlTemplateMessageSource) {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.setTemplateResolver(htmlTemplateResolver());
        templateEngine.setTemplateEngineMessageSource(htmlTemplateMessageSource);
        templateEngine.setEnableSpringELCompiler(true);
        templateEngine.addDialect(new SpringSecurityDialect());
        return templateEngine;
    }

    @Bean
    public ViewResolver viewResolver(SpringTemplateEngine templateEngine) {
        ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
        viewResolver.setTemplateEngine(templateEngine);
        viewResolver.setCharacterEncoding("UTF-8");
        viewResolver.setOrder(1);
        return viewResolver;
    }

    @Bean // 新增该注解，将解析器注册为Spring Bean
    public SpringResourceTemplateResolver htmlTemplateResolver() {
        SpringResourceTemplateResolver templateResolver = new SpringResourceTemplateResolver();
        templateResolver.setApplicationContext(applicationContext);
        templateResolver.setPrefix("classpath:templates/web/");
        templateResolver.setSuffix(".html");
        templateResolver.setTemplateMode(TemplateMode.HTML);
        templateResolver.setCharacterEncoding("UTF-8");
        templateResolver.setOrder(0);
        return templateResolver;
    }
}

注册后IntelliJ可通过Spring上下文识别到模板路径配置。

2. 手动配置IntelliJ的Spring MVC视图解析器 #

若上述方法无效，可直接告知IDE视图映射规则：

• 打开File > Settings > Languages & Frameworks > Spring > Spring MVC
• 在View Resolvers区域点击+，添加Thymeleaf View Resolver
• 设置Prefix为classpath:templates/web/，Suffix为.html
• 保存设置后重新加载项目

3. 标记模板目录类型 #

确保templates/web下的.html文件被识别为Thymeleaf模板：

• 右键点击web文件夹，选择Mark Directory as > Template Resources Root
• 或在File > Project Structure > Modules > [你的模块] > Sources中，将templates/web标记为Template Resources

4. 更新IntelliJ Spring Boot插件 #

旧版本插件对自定义Thymeleaf配置的支持可能存在缺陷：

• 打开File > Settings > Plugins，找到Spring Boot插件检查更新，更新完成后重启IDE

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