Restlet 2.3.12生成Swagger文档遇NoSuchMethodError异常求助

这个问题我之前帮别人排查过，核心就是Restlet版本和Jackson版本的兼容性不匹配，咱们一步步来解决：

问题根源 #

你遇到的java.lang.NoSuchMethodError是因为Restlet 2.3.12内部依赖的Jackson方法签名，和你引入的2.7-2.9版本的Jackson不兼容。具体来说，Jackson在2.7版本修改了AnnotatedClass.construct的方法参数，而Restlet 2.3.12是基于Jackson 2.6.x开发的，调用旧方法时自然找不到。

具体解决方案 #

1. 切换到Restlet官方兼容的Jackson版本 #

Restlet 2.3.x系列稳定兼容的Jackson版本是2.6.7，你需要把项目中的Jackson依赖统一改成这个版本，替换掉之前的2.7-2.9版本。

Maven项目配置

在pom.xml中添加以下依赖，并排除其他依赖带进来的高版本Jackson：

<!-- 强制指定兼容的Jackson版本 -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.6.7</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.6.7</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.6.7</version>
</dependency>

<!-- 示例：排除Spring等依赖自带的Jackson -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>你的Spring版本</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle项目配置

在build.gradle中配置：

dependencies {
    // 强制指定兼容的Jackson版本
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.6.7'
    implementation 'com.fasterxml.jackson.core:jackson-core:2.6.7'
    implementation 'com.fasterxml.jackson.core:jackson-annotations:2.6.7'

    // 示例：排除其他依赖自带的Jackson
    implementation('org.springframework:spring-web:你的Spring版本') {
        exclude group: 'com.fasterxml.jackson.core', module: 'jackson-databind'
    }
}

2. 清理依赖缓存并重新构建 #

• Maven执行：mvn clean install -U
• Gradle执行：gradle clean build --refresh-dependencies

这一步是为了确保项目拉取的是正确版本的Jackson依赖，避免缓存中的旧版本干扰。

3. 验证结果 #

重新运行生成Swagger文档的代码，此时应该不会再抛出NoSuchMethodError异常了。

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