启动Alfresco遇java.lang.NoSuchMethodError(LoggingHandler)异常求助

问题本质 #

这就是典型的Netty版本冲突——你虽然只通过Spring Boot Starter Webflux引入Netty，但Alfresco自身依赖的Netty版本和Webflux带的版本不兼容，导致运行时加载的LoggingHandler类找不到对应的构造方法，直接抛出异常。

一步步解决 #

• 强制锁死Netty版本：直接在构建文件里指定和Spring Boot适配的Netty版本，覆盖Alfresco自带的版本：
  • Maven（pom.xml）：

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>io.netty</groupId>
                <artifactId>netty-all</artifactId>
                <!-- 版本号用Spring Boot依赖管理里的，比如2.7.x对应4.1.82.Final -->
                <version>4.1.82.Final</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    

  • Gradle（build.gradle）：

    configurations.all {
        resolutionStrategy.force 'io.netty:netty-all:4.1.82.Final'
    }
    

• 揪出冲突来源：跑命令查看依赖树，确认是Alfresco哪个模块带了冲突的Netty：

  # Maven
  mvn dependency:tree | grep netty
  # Gradle
  gradle dependencies | grep netty
  

• Docker镜像校验：构建完镜像后，进入容器查看BOOT-INF/lib下的netty jar版本是否统一，避免遗留旧版本包。
• WebClient配置检查：如果自定义了WebClient配置，不要手动引入其他版本的Netty组件，全部使用Spring Boot提供的依赖即可。

关键点提醒 #

NoSuchMethodError基本都是编译与运行时依赖版本不匹配导致的，这里核心是让整个应用的Netty版本完全一致，优先采用Spring Boot适配的版本，避免Alfresco自带的旧版本Netty干扰。

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