Spring Web项目中无法自动装配AsyncHttpClient问题求助

1. 先排查依赖完整性问题 #

ClassNotFoundException最常见的原因是依赖缺失或不完整，AsyncHttpClient 2.x底层依赖Netty，有时候依赖传递会被截断：

• 确认Maven/Gradle依赖是否正确引入了完整的async-http-client包：
  Maven示例：

  <dependency>
      <groupId>org.asynchttpclient</groupId>
      <artifactId>async-http-client</artifactId>
      <version>2.12.3</version>
  </dependency>
  

• 用依赖树命令检查是否有冲突或缺失：
  Maven：mvn dependency:tree，Gradle：./gradlew dependencies，看是否有其他版本的async-http-client或Netty依赖冲突，有的话用<exclusions>排除掉。
• 确认jar包已加载到classpath：IDE中查看Project Structure -> Libraries，检查async-http-client-2.12.3.jar是否存在，且内部包含org.asynchttpclient.AsyncHttpClient类；打包运行的话，解压jar包确认依赖是否被正确打包。

2. 修正Bean配置方式 #

你提到“在同一类中配置该Bean”，如果是在@RestController里写@Bean方法，这是错误的——@RestController不会触发内部@Bean方法的扫描注册，必须用@Configuration类来配置Bean：

@Configuration
public class AsyncHttpClientConfig {
    @Bean
    public AsyncHttpClient asyncHttpClient() {
        // 用Dsl创建实例是2.x版本的标准方式
        return Dsl.asyncHttpClient();
    }
}

之后在@RestController中正常注入即可（推荐用构造器注入，避免字段注入的潜在问题）：

@RestController
public class MyController {
    private final AsyncHttpClient asyncHttpClient;

    public MyController(AsyncHttpClient asyncHttpClient) {
        this.asyncHttpClient = asyncHttpClient;
    }

    // 你的POST请求处理方法...
}

如果非要在控制器类里配置Bean，必须给控制器加上@Configuration注解，但这违反单一职责原则，不推荐。

3. 排除循环引用的干扰 #

你开启的spring.main.allow-circular-references=true和当前的ClassNotFoundException无关——循环引用抛出的是BeanCurrentlyInCreationException，不是类找不到异常，这个配置可以先忽略，聚焦类路径和Bean配置问题。

4. 针对异常堆栈的精准排查 #

如果异常中找不到的是org.asynchttpclient.AsyncHttpClient本身，那就是依赖没拉对；如果是Netty相关的类（比如io.netty.handler.codec.http.HttpResponse），说明Netty依赖被意外排除，需要手动引入对应版本的Netty依赖（和AsyncHttpClient 2.12.3兼容的Netty版本是4.1.x系列）。

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