问题出现
在开发项目过程中,今天在启动一个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腾讯技术创作特训营第三期有奖征文,组队打卡瓜分大奖!