SpringBoot中配置freemarker忽略自动配置

朴灿烈づ我的快乐病毒、 2023-09-27 15:55 77阅读 0赞

![a761b365388206abfcb5fd043a745b59.png][]

### 问题出现 ###

在开发项目过程中，今天在启动一个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行。追寻这个意思，我们可以循着他看到我下面的图。

![14c02cc70fdb7d27716327bced600d1a.png][]

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

![ede306dbaaca5a935fd5fb0d6acb1572.png][]

### 解决方法 ###

#### 方法一 ####

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（⌘）+ ,

![197e9c787a868242b224d318468c542c.png][]

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

![2bb1ee1cdbc0af70514c8593fa70ffa0.png][]

配置FreeMarker等错误、告警信息

![064eee4e11005d588b8ee197ef0a3712.png][]

### 总结 ###

有问题不怕，要相信解决办法总比问题多。

[a761b365388206abfcb5fd043a745b59.png]: https://img-blog.csdnimg.cn/img_convert/a761b365388206abfcb5fd043a745b59.png
[14c02cc70fdb7d27716327bced600d1a.png]: https://img-blog.csdnimg.cn/img_convert/14c02cc70fdb7d27716327bced600d1a.png
[ede306dbaaca5a935fd5fb0d6acb1572.png]: https://img-blog.csdnimg.cn/img_convert/ede306dbaaca5a935fd5fb0d6acb1572.png
[197e9c787a868242b224d318468c542c.png]: https://img-blog.csdnimg.cn/img_convert/197e9c787a868242b224d318468c542c.png
[2bb1ee1cdbc0af70514c8593fa70ffa0.png]: https://img-blog.csdnimg.cn/img_convert/2bb1ee1cdbc0af70514c8593fa70ffa0.png
[064eee4e11005d588b8ee197ef0a3712.png]: https://img-blog.csdnimg.cn/img_convert/064eee4e11005d588b8ee197ef0a3712.png