spring中类名相同，但包名不同，导致spring启动失败解决方案

朴灿烈づ我的快乐病毒、 2022-12-22 00:47 483阅读 0赞

背景：本项目引入了一个三方jar包，但jar中出现了一个类名相同，但包名不同，导致spring启动失败 解决方案：

方案一：排查下在本项目调用过程中是否不会用到某一个深层jar，要是没用到，则在引入该jar的坐标时用以下方式排除掉该冲突类所在的深层jar

1. `<dependency>`
2. `<artifactId>三方jar</artifactId>`
3. `<groupId>三方jar</groupId>`
4. `<version>三方jar</version>`
5. `<exclusions>`
6. `<exclusion>`
7. `<artifactId>冲突包所在的深层jar</artifactId>`
8. `<groupId>冲突包所在的深层jar</groupId>`
9. `</exclusion>`
10. `</exclusions>`
11. `</dependency>`

方案二：排出下本项目在调用过程中是否不会用到某一个冲突的类（两个都用不到更好，不过只为了解决冲突，则只需处理一个即可），要是没用到，则在spring扫描该jar包时，将该类忽略掉不加载即可。这种方式比第一个更精确

1. `<context:component-scan base-package="com.*" >`
2. `<context:exclude-filter type="annotation" expression="冲突类全名（包含包路径啊）"/>`
3. `</context:component-scan>`

方案三：转载其他地方的（原地址：[https://www.cnblogs.com/bedlimate/p/8660839.html][https_www.cnblogs.com_bedlimate_p_8660839.html]）

项目背景：

某日，有需求要在三天的时间内完成两个大项目的项目合并，因为之前两个项目的包结构和类名都很多相同，于是开始考虑使用加一级包进行隔离，类似于这种结构

![format_png][]

但是在启动的过程中，抛出来这样的异常：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 </td> 
 <td> <code>Caused by: org.springframework.context.annotation.ConflictingBeanDefinitionException: Annotation-specified bean name&nbsp;</code><code>'nameConflict'</code>&nbsp;<code>for</code>&nbsp;<code>bean&nbsp;</code><code>class</code>&nbsp;<code>[xom.liuyun.beannameconflict.modelB.NameConflict] conflicts with existing, non-compatible bean definition of same name and&nbsp;</code><code>class</code>&nbsp;<code>[xom.liuyun.beannameconflict.modelA.NameConflict]</code> <code>at org.springframework.context.annotation.ClassPathBeanDefinitionScanner.checkCandidate(ClassPathBeanDefinitionScanner.java:</code><code>348</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>at org.springframework.context.annotation.ClassPathBeanDefinitionScanner.doScan(ClassPathBeanDefinitionScanner.java:</code><code>286</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>at org.springframework.context.annotation.ComponentScanAnnotationParser.parse(ComponentScanAnnotationParser.java:</code><code>132</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>at org.springframework.context.annotation.ConfigurationClassParser.doProcessConfigurationClass(ConfigurationClassParser.java:</code><code>284</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>at org.springframework.context.annotation.ConfigurationClassParser.processConfigurationClass(ConfigurationClassParser.java:</code><code>241</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>at org.springframework.context.annotation.ConfigurationClassParser.parse(ConfigurationClassParser.java:</code><code>198</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>at org.springframework.context.annotation.ConfigurationClassParser.parse(ConfigurationClassParser.java:</code><code>166</code><code>) ~[spring-context-</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE.jar:</code><code>5.0</code><code>.</code><code>4</code><code>.RELEASE]</code> <code>...&nbsp;</code><code>13</code>&nbsp;<code>common frames omitted。</code> </td> 
 </tr> 
 </tbody> 
</table>

原因：

spring提供两种beanName生成策略，基于注解的sprong-boot默认使用的是AnnotationBeanNameGenerator，它生成beanName的策略就是，取当前类名（不是全限定类名）作为beanName。由此，如果出现不同包结构下同样的类名称，肯定会出现冲突。

解决方案如下：

1. 自己写一个类实现 org.springframework.beans.factory.support.BeanNameGeneraot接口

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 </td> 
 <td> <code>public</code>&nbsp;<code>class</code>&nbsp;<code>UniqueNameGenerator&nbsp;</code><code>extends</code>&nbsp;<code>AnnotationBeanNameGenerator { </code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>@Override</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>String generateBeanName(BeanDefinition definition, BeanDefinitionRegistry registry) { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>//全限定类名</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>String beanName = definition.getBeanClassName();</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>return</code>&nbsp;<code>beanName;</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

2. 在启动类上加注解@ComponentScan(nameGenerator = UniqueNameGenerator.class)使刚才我们自定义的BeanName生成策略生效。

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 </td> 
 <td> <code>@SpringBootApplication</code> <code>@ComponentScan</code><code>(nameGenerator = UniqueNameGenerator.</code><code>class</code><code>)</code> <code>public</code>&nbsp;<code>class</code>&nbsp;<code>BeanNameConflictApplication { </code> &nbsp; <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>public</code>&nbsp;<code>static</code>&nbsp;<code>void</code>&nbsp;<code>main(String[] args) { </code> <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>SpringApplication.run(BeanNameConflictApplication.</code><code>class</code><code>, args);</code> <code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code> <code>}</code> </td> 
 </tr> 
 </tbody> 
</table>

这样，问题就可以解决了。

[https_www.cnblogs.com_bedlimate_p_8660839.html]: https://www.cnblogs.com/bedlimate/p/8660839.html
[format_png]: /images/20221120/9558cee4d18144d2a8e7850fb0345f0f.png