Springboot使用Maven占位符@替换不生效问题及解决

 更新时间:2023年04月03日 09:44:21   作者:王坦.  
这篇文章主要介绍了Springboot使用Maven占位符@替换不生效问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教

使用Maven占位符@替换不生效

使用@符号作为占位符,maven变量却发现不生效,进入 spring-boot-starter-parent 才发现有如下配置,也就是说springboot除了定义@符号作为占位符之外,其实还限制了其替换范围!

<resources>
      <resource>
        <directory>${basedir}/src/main/resources</directory>
        <filtering>true</filtering>
        <includes>
          <include>**/application*.yml</include>
          <include>**/application*.yaml</include>
          <include>**/application*.properties</include>
        </includes>
      </resource>
      <resource>
        <directory>${basedir}/src/main/resources</directory>
        <excludes>
          <exclude>**/application*.yml</exclude>
          <exclude>**/application*.yaml</exclude>
          <exclude>**/application*.properties</exclude>
        </excludes>
      </resource>
    </resources>

所以为了增加对bootstrap.yml文件的支持,增加以下配置,注意资源要include和exclude成组,否则resources文件夹下其他文件不会被拷贝!

<resources>
    <!-- springboot 默认只替换application*.[yml,yaml,properties]相关文件,我们项目中在bootstrap中需要替换配置中心等相关变量 -->
    <resource>
        <filtering>true</filtering>
        <directory>${basedir}/src/main/resources</directory>
        <includes>
            <include>**/bootstrap*.yml</include>
            <include>**/bootstrap*.yaml</include>
            <include>**/bootstrap*.properties</include>
        </includes>
    </resource>
    <!-- 必须成组否则文件夹下其他资源无法拷贝 -->
    <resource>
        <directory>${basedir}/src/main/resources</directory>
        <excludes>
            <exclude>**/bootstrap*.yml</exclude>
            <exclude>**/bootstrap*.yaml</exclude>
            <exclude>**/bootstrap*.properties</exclude>
        </excludes>
    </resource>
</resources>

spring占位符无法替换的报错排查

开发环境

  • jdk:1.8
  • mybatis:3.4.5
  • spring:5.1.9

问题背景和报错信息

1.Springmvc的项目转成springboot的项目,该项目依赖了一些其他业务组的jar,比如dependency-core:0.0.1, dependency-extensions:0.0.1(并非真实的jar名称)。该项目的配置基本都是通过xml完成的,在xml里面定义了一些PropertyPlaceholderConfigurer。并且在该项目的xml里面又import了dependency-core和dependency-extensions里面的xml文件,这些xml文件里面也同样定义了PropertyPlaceholderConfigurer和MapperScanner。

2.项目迁移到springboot后,启动报错,概要信息是说某一个占位符${dependency.core.db.url}(并非真实的占位符名称)找不到。

问题分析思路

PropertyPlaceholderConfigurer里面的配置信息没有加载到。

有某些bean触发了提前初始化,导致PropertyPlaceholderConfigurer 的postProcessBeanFactory方法没有执行,导致占位符没有被替换。

具体排查过程

思路1的排查过程

删除依赖的其他项目的xml(如dependency-a.xml, dependency-b.xml),把底层xml里面的PropertyPlaceholderConfigurer显示的配置在本项目中。

启动服务,进行debug,在PropertyPlaceholderConfigurer里面打断点,发现是可以加载正确的配置信息的。

所以排除这个方向

思路2的排查过程

先逐步的把依赖的其他的xml配置文件一个一个的引入到本项目,直到引入其中一个时,服务启动报错,这样先定位具体是哪个xml配置文件导致的

把问题xml里面的配置想,copy到本项目,copy过来后,全部注释掉,从第一个配置项开始,逐一打开注释,然后启动服务,进行测试,直到发现是哪一段配置项导致了目标异常

经过排查,发现报错的触发项是一段mapper scanner

<bean id="222222" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.xxx.dao"/>
    <property name="sqlSessionFactoryBeanName" value="dependencyCoreSessionFactory"/>
</bean>

然后在MapperScannerConfigurer的postProcessBeanDefinitionRegistry方法中debug,逐步跟进。

最终进入到ClassPathBeanDefinitionScanner到doScan方法,

protected Set<BeanDefinitionHolder> doScan(String... basePackages) {
        Assert.notEmpty(basePackages, "At least one base package must be specified");
        Set<BeanDefinitionHolder> beanDefinitions = new LinkedHashSet<>();
        for (String basePackage : basePackages) {
            Set<BeanDefinition> candidates = findCandidateComponents(basePackage);
            for (BeanDefinition candidate : candidates) {
                ScopeMetadata scopeMetadata = this.scopeMetadataResolver.resolveScopeMetadata(candidate);
                candidate.setScope(scopeMetadata.getScopeName());
                String beanName = this.beanNameGenerator.generateBeanName(candidate, this.registry);
                if (candidate instanceof AbstractBeanDefinition) {
                    postProcessBeanDefinition((AbstractBeanDefinition) candidate, beanName);
                }
                if (candidate instanceof AnnotatedBeanDefinition) {
                    AnnotationConfigUtils.processCommonDefinitionAnnotations((AnnotatedBeanDefinition) candidate);
                }
                if (checkCandidate(beanName, candidate)) {
                    BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, beanName);
                    definitionHolder =
                            AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry);
                    beanDefinitions.add(definitionHolder);
                    registerBeanDefinition(definitionHolder, this.registry);
                }
            }
        }
        return beanDefinitions;
    }

最后的if判断那里会检查是否有同名的不兼容的bean,这个地方是罪魁祸首。这个发生了报错,信息如下。

Annotation-specified bean name 'xxxDao' for bean class [com.xxx.XXXDao] 
conflicts with existing, 
non-compatible bean definition of same name and class [org.mybatis.spring.mapper.MapperScannerConfigurer]

这就说明有同名的Bean,经过查找,果然本项目内部定义了一个和其他jar里面同包名,同类名的 Dao类。

那么把本项目内的Dao类改个名字即可,问题解决。

注意:

报错异常是表象,具体原因还得深究。

这个问题可能不举报普遍性,主要关注排查思路。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • java显示当前的系统时间

    java显示当前的系统时间

    这篇文章主要介绍了java如何显示当前的系统时间,代码很简单,自己可以自定义显示的系统时间的颜色和字体,需要的朋友可以参考下
    2015-10-10
  • Java设计模式之单例和原型

    Java设计模式之单例和原型

    这篇文章介绍了Java设计模式之单例和原型,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-09-09
  • 实例解析JAVA中代码的加载顺序

    实例解析JAVA中代码的加载顺序

    这篇文章主要介绍了举例说明Java中代码块的执行顺序,需要的朋友可以参考下
    2017-04-04
  • SpringBoot Redis批量存取数据的操作

    SpringBoot Redis批量存取数据的操作

    这篇文章主要介绍了SpringBoot Redis批量存取数据的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-08-08
  • 为什么不要使用 async void的原因分析

    为什么不要使用 async void的原因分析

    这篇文章主要介绍了为什么不要使用 async void的原因分析及解决方法,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-04-04
  • Java中的CountDownLatch闭锁详解

    Java中的CountDownLatch闭锁详解

    这篇文章主要介绍了Java中的CountDownLatch闭锁详解,CountDownLatch用给定的计数初始化,await属于阻塞方法,直到当前计数达到零,由于countDown方法被调用,然后释放所有await等待的线程,并立即返回线程后续的await调用逻辑,需要的朋友可以参考下
    2023-12-12
  • 九个动画组图轮播总结全栈数据结构数组链表

    九个动画组图轮播总结全栈数据结构数组链表

    数据结构和算法是密不可分的,两者往往是相辅相成的存在,所以在学习数据结构过程中,不免会遇到各种算法,数据结构常用操作一般为:增删改查。基本上所有的数据结构都是围绕这几个操作进行展开,本文用九张动图来阐述先进后出的数据结构
    2021-08-08
  • MyBatis配置与CRUD超详细讲解

    MyBatis配置与CRUD超详细讲解

    这篇文章主要介绍了MyBatis配置与CRUD,CRUD是指在做计算处理时的增加(Create)、读取(Read)、更新(Update)和删除(Delete)几个单词的首字母简写。CRUD主要被用在描述软件系统中数据库或者持久层的基本操作功能
    2023-02-02
  • SpringCloud微服务熔断器Hystrix使用详解

    SpringCloud微服务熔断器Hystrix使用详解

    这篇文章主要介绍了Spring Cloud Hyxtrix的基本使用,它是Spring Cloud中集成的一个组件,在整个生态中主要为我们提供服务隔离,服务熔断,服务降级功能,本文给大家介绍的非常详细,需要的朋友可以参考下
    2022-07-07
  • Spring Security OAuth2 实现登录互踢的示例代码

    Spring Security OAuth2 实现登录互踢的示例代码

    这篇文章主要介绍了Spring Security OAuth2实现登录互踢的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-04-04

最新评论