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

2023-11-21 01:51:01 浏览数 (2)

问题出现

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

代码语言:javascript复制
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格式的。

在配置文件中,增加如下配置:

代码语言:javascript复制
spring.freemarker.checkTemplateLocation=false

或者

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

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

代码语言:javascript复制
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 的自动装配。

代码语言:javascript复制
@SpringBootApplication(exclude = {FreeMarkerAutoConfiguration.class})

方法四

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

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

或者快捷方式:command(⌘) ,

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

配置FreeMarker等错误、告警信息

总结

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


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

0 人点赞