开发技巧｜SpringBoot中配置freemarker自动配置忽略告警

问题出现

在开发项目过程中，今天在启动一个SpringBoot项目时，发现SpringBoot项目启动后，在控制台看到这样一个警告告警：

2023-09-30 14:30:32.956 [main] WARN  o.s.b.a.freemarker.FreeMarkerAutoConfiguration:65 - Cannot find template location(s): [classpath:/templates] (please add some templates, check your FreeMarker configuration, or set spring.freemarker.checkTemplateLocation=false)

针对于[main] WARN这种告警，其实你可以忽略不必管它。但你如果不想看到它，想知道什么原因的话。其实这个提示还是比较明确的。

问题思考

首先看下这个告警出现的原因，追寻这个告警，可以大体来猜测下这个类所出现的路径——o.s.b.a （最笨的方法就是去依赖库每个包看下）根据这个我们其实是大题上可以猜测出来是这个类所指：org.springframework.boot.autoconfigure.freemarker

其实就是每个包的包名称首字母的缩写，找到这里，再来看下这里是哪一个文件freemarker.FreeMarkerAutoConfiguration:65 看到这里，是不是心里有了明镜？在freemarker文件夹下面的FreeMarkerAutoConfiguration.java类中的第65行。追寻这个意思，我们可以循着他看到我下面的图。

再来看看这个警告出现的意思，在检查FreeMarker模版时，在classpath:/templates找不到本地模版位置，请添加他或者设置spring.freemarker.checkTemplateLocation=false ，（白话其实就是不检查），当我知道问题出现的位置以及问题出现的原因时，那么我们就开始手动解决他吧。

解决方法

方法一

1、在项目的 /src/main/resources/templates 目录下添加一个模板文件，比如simple.jsp 或 simple.ftl 的模版文件（其实，第1步可以不用做，可以直接使用2步骤来处理，我个人也比较推荐使用第二种方式）。

方法二

2、打开项目配置文件 application.properties（或者有的是application.yml、bootstrap.yml），有的人可能喜欢使用 .yml 或者.yaml格式的。

在配置文件中，增加如下配置：

spring.freemarker.checkTemplateLocation=false

或者

spring:
  application:
    name: [appName]
  cloud:
    nacos:
      config:
        server-addr: [IP]
   discovery:
   	server-addr: [IP]
  # 在Spring的配置项下面配置检查本地模版文件为false即可
  freemarker:
    checkTemplateLocation: false

如果需要配置FreeMarker模版作为模版引擎，我们可以按照下面的方式来处理。除了FreeMarker模版引擎，其实我们也还可以使用thymeleaf模版引擎，这里不再赘述。

spring:
 freemarker:
   # req访问request
 	request-context-attribute: req  
   # 后缀名
    suffix: .html  
    content-type: text/html
    enabled: true
 	# 缓存配置
    cache: false 
   # 模板加载路径 按需配置（这里就是我们上面的忽略配置）
    template-loader-path: classpath:/templates/ 
   # 编码格式
    charset: UTF-8 
    settings:
     # 数字格式化，无小数点
     number_format: '0.##'

方法三

3、第三种方式就是在我们的启动入口配置，此时我们只想用freemarker来渲染处理xml文件，但是不想使用它作为模板引擎，这时需要关掉freemarker 的自动装配。

@SpringBootApplication(exclude = {FreeMarkerAutoConfiguration.class})

方法四

4、这第四种方式，也是比较简单的，一劳永逸，那就是关闭这种告警，眼不见心不烦，针对有洁癖的可以使用这种方式。这种方式就是关闭告警。

Mac模式下：InteIIiJ IDEA ==> Preferences... ==>Editor ==> Inspections ==>

或者快捷方式：command（⌘）+ ,

配置Spring、SpringBoot、SpringCloud等错误、告警信息

配置FreeMarker等错误、告警信息

总结

有问题不怕，要相信解决办法总比问题多。当然，这个也取决于自己的是否有强迫症。

我正在参与2023腾讯技术创作特训营第三期有奖征文，组队打卡瓜分大奖！