背景
把微信扫码登录的功能从一个项目迁移到另一个项目中,
框架SpringBoot,使用开源项目weixin-java-mp
com.github.binarywang
weixin-java-mp
4.4.0
在相关代码粘贴好之后,启动时出现:
Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException:
Error creating bean with name 'districtServiceImpl':
Unsatisfied dependency expressed through field 'webUserService';
nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException:
Error creating bean with name 'webUserServiceImpl' defined in file [/Users/lyx/code/smart-community/api/target/classes/club/yunzhi/smartcommunity/service/WebUserServiceImpl.class]:
Unsatisfied dependency expressed through constructor parameter 2;
nested exception is org.springframework.beans.factory.BeanCreationException:
Error creating bean with name 'weChatMpService':
Invocation of init method failed; nested exception is java.lang.NoClassDefFoundError:
me/chanjar/weixin/common/api/WxMessageInMemoryDuplicateCheckerSingleton
为了便于观看,已经进行手动换行,分析报错信息得知,出现依赖注入问题,
异常类型:java.lang.NoClassDefFoundError
districtServiceImpl -> webUserService -> weChatMpService -> WxMessageInMemoryDuplicateCheckerSingleton失败
最终原因是这个类WxMessageInMemoryDuplicateCheckerSingleton
找不到
排查
(提示:代码不用细看,每个人遇到的问题不完全一样)
上面的注入过程中,除了WxMessageInMemoryDuplicateCheckerSingleton
是内部类,其他都是自己写的类
简单检查了一下调用过程,直接搜索报错的类搜不到结果,
然后往回找,在weChatMpService中有一个 new WxMpMessageRouter的操作(用于处理不同类型的微信消息):
final WxMpMessageRouter newRouter = new WxMpMessageRouter(this);
而这个WxMpMessageRouter的构造函数中出现了报错信息中的类:
this.messageDuplicateChecker = WxMessageInMemoryDuplicateCheckerSingleton.getInstance();
这就找到了问题具体的位置,但内部类的问题,我们是没办法直接解决的。
然后去 Gooooooogle, 在GitHub 的项目 issue 中找到了类似的问题:
虽然包名不一样但原因相同,开发者也给出了原因:
想到这个项目以前虽然没使用过公众号的组件,但用过小程序的组件,
仔细一看自己项目的 pom 发现,公众号和小程序的组件的版本确实不一样
由于先引入的小程序,所以 maven 的库就变成了这样:
所以才导致了公众号组件对 common 组件调用失败
解决办法:保持版本一致
本着“最小修改”的原则,计划把公众号组件和已有版本保持一致,改回4.1版本
com.github.binarywang
weixin-java-mp
4.1.0
com.github.binarywang
wx-java-mp-spring-boot-starter
4.1.0
然后pom.xml -> maven -> 重新加载项目
启动成功:
总结
当使用com.github.binarywang
的开源微信组件家族时,需要保持多个组件的版本相同,否则就会出现 common 包和某个具体的包版本不一致的情况,进而导致某些类的依赖注入失败
最后留个开源项目地址:https://github.com/Wechat-Gro...