Maven引入未声明依赖：项目传递依赖版本不符问题排查

可能的遗漏点 #

• Maven依赖调解优先级：虽然你认为没有其他地方引入该依赖，但可能存在某个间接依赖（非Spring Boot）引入了3.1.0版本，且由于依赖路径更短或声明顺序更早，Maven根据依赖调解规则选择了3.1.0而非3.1.4。
• 项目B的依赖声明位置错误：若项目B仅在<dependencyManagement>中声明了3.1.4版本，而非<dependencies>块内，该依赖不会自动传递给项目A，此时项目A可能通过其他间接依赖引入3.1.0。
• 依赖传递被阻断：项目B中mariadb-java-client的<scope>被设置为provided或test，导致依赖无法传递给项目A，项目A的其他依赖趁机引入了旧版本。
• 项目A的依赖排除操作：项目A在依赖项目B时，可能无意中排除了mariadb-java-client，后续通过其他路径引入了3.1.0。

解决步骤 #

1. 精准定位依赖来源
   执行Maven命令仅排查该依赖的所有引入路径：

   mvn dependency:tree -Dverbose -Dincludes=org.mariadb.jdbc:mariadb-java-client
   

   该命令会输出所有引入mariadb-java-client的依赖链，你可以清晰看到哪个模块引入了3.1.0版本。

2. 针对性修复

   • 若发现是其他间接依赖引入旧版本：在项目A的<dependencies>中，对引入旧版本的依赖添加排除规则，或者在项目A的<dependencyManagement>块中强制声明3.1.4版本（优先级最高）：

     <dependencyManagement>
         <dependencies>
             <dependency>
                 <groupId>org.mariadb.jdbc</groupId>
                 <artifactId>mariadb-java-client</artifactId>
                 <version>3.1.4</version>
             </dependency>
         </dependencies>
     </dependencyManagement>
     

   • 若项目B的依赖仅在dependencyManagement中：确保项目B的<dependencies>内实际声明该依赖，而非仅管理版本。
   • 若scope设置异常：检查项目B中该依赖的<scope>，改为默认的compile（无需显式声明），确保依赖可传递。
   • 若存在意外排除：检查项目A依赖项目B的配置，移除对mariadb-java-client的排除规则。

3. 清理本地缓存
   若上述操作无效，可能是本地Maven仓库缓存了旧版本，执行命令强制更新依赖：

   mvn clean install -U
   

内容的提问来源于stack exchange，提问作者Samhitha Parneni