spring boot自定义endpoint（SpringBoot中配置freemarker忽略自动配置）

spring boot自定义endpoint（SpringBoot中配置freemarker忽略自动配置）(1)

问题出现

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

2022-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行。追寻这个意思，我们可以循着他看到我下面的图。

spring boot自定义endpoint（SpringBoot中配置freemarker忽略自动配置）(2)

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

spring boot自定义endpoint（SpringBoot中配置freemarker忽略自动配置）(3)

解决方法方法一

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

方法二

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

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

spring.freemarker.checkTemplateLocation=false

或者

spring: application: name: xxx cloud: nacos: config: server-addr: xxx discovery: server-addr: xxx # 在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 boot自定义endpoint（SpringBoot中配置freemarker忽略自动配置）(4)