Springboot使用Maven占位符@替換不生效問題如何解決

這篇文章主要介紹了Springboot使用Maven占位符@替換不生效問題如何解決的相關知識，內容詳細易懂，操作簡單快捷，具有一定借鑒價值，相信大家閱讀完這篇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類改個名字即可，問題解決。

注意：

報錯異常是表象，具體原因還得深究。

這個問題可能不舉報普遍性，主要關注排查思路。

關于“Springboot使用Maven占位符@替換不生效問題如何解決”這篇文章的內容就介紹到這里，感謝各位的閱讀！相信大家對“Springboot使用Maven占位符@替換不生效問題如何解決”知識都有一定的了解，大家如果還想學習更多知識，歡迎關注億速云行業資訊頻道。