Pushy APNS开发苹果推送时触发Netty PromiseCombiner的NoSuchMethodError
问题诱因
本次抛出的java.lang.NoSuchMethodError是典型的依赖版本类冲突问题,与业务推送逻辑无关:
- 从报错堆栈可知,运行时实际加载的Netty类来自
netty-common-4.1.23.Final、netty-all-4.1.23.Final版本,和项目POM中显式声明的4.1.48.Final版本不一致,类路径上存在多版本Netty并存的冲突,低版本Netty类被优先加载。 - 报错提示缺失的
io.netty.util.concurrent.PromiseCombiner.<init>(EventExecutor)构造方法,是Netty 4.1.30版本之后新增的API,4.1.23这类低版本中无对应实现,Pushy 0.14.2运行调用时就会抛出方法不存在的错误。 - 显式声明的高版本Netty未生效的核心原因:Pushy 0.14.2的传递依赖会引入指定版本的Netty(即4.1.23.Final),按照Maven依赖仲裁规则,路径更近的低版本依赖会抢占类加载优先级,手动配置的高版本依赖未被实际加载。
排查与解决方案
- 在项目根目录执行
mvn dependency:tree -Dincludes=io.netty,梳理所有引入Netty依赖的路径,定位传递引用4.1.23低版本的依赖源头。 - 移除项目中手动配置的
netty-all聚合依赖,避免Netty各模块版本不一致。 - 在Maven的
<dependencyManagement>节点统一管理全项目的Netty兼容版本,确保所有io.netty相关模块版本完全一致;对传递引入低版本Netty的依赖项,通过<exclusion>配置排除其自带的低版本Netty依赖,保证类路径上仅存在一套Netty类文件。 - 重新执行依赖树检查命令,确认类路径上无残留4.1.23等旧版本Netty依赖后,启动项目复现推送流程,验证错误是否消失。
- 修正原代码的异步逻辑缺陷:原代码在遍历完设备Token列表后立刻执行
client.close(),由于whenComplete是异步回调逻辑,立刻关闭客户端会导致后续异步响应无法正常处理,需要在所有推送任务全部完成回调后再执行客户端关闭操作。
内容的提问来源于stack exchange,提问作者Toufic Sleiman
相关产品推荐
相关产品推荐

