Azure依赖Netty传递依赖缺失引发NoClassDefFoundError问题求助

库B的单元/集成测试能正常运行，但项目A启动时出现Netty类找不到的错误，核心原因集中在依赖传递环节：

• Azure SDK的Netty依赖为可选依赖：azure-core-http-netty对Netty的依赖可能被标记为<optional>true</optional>，导致依赖不会自动传递到上层项目A。
• 项目A的依赖树中Netty被主动排除：项目A或其依赖的其他库可能通过<exclusions>配置移除了Netty相关依赖。
• 库B的Azure依赖范围错误：如果库B中Azure依赖的<scope>被设为test或provided，这些依赖不会被传递到项目A的运行时classpath中。

1. 排查依赖传递状态 #

在项目A的根目录执行Maven命令，精准查看Netty的依赖情况：

mvn dependency:tree -Dincludes=io.netty

如果输出为空，说明Netty未被传递到项目A；若存在排除记录，定位到对应的依赖配置。

2. 调整库B的依赖配置 #

若Azure的Netty依赖为可选，在库B的pom.xml中显式引入Netty核心依赖（版本与Azure SDK依赖的版本保持一致即可）：

<dependency>
    <groupId>io.netty</groupId>
    <artifactId>netty-handler</artifactId>
    <version>4.1.100.Final</version> <!-- 版本可根据azure-core-http-netty的实际依赖调整 -->
</dependency>
<dependency>
    <groupId>io.netty</groupId>
    <artifactId>netty-resolver</artifactId>
    <version>4.1.100.Final</version>
</dependency>

这样项目A依赖库B时，Netty依赖会自动完成传递。

3. 移除项目A的不必要依赖排除 #

如果项目A的某个依赖排除了Netty，找到对应的<exclusions>配置并移除：

<dependency>
    <groupId>第三方库groupId</groupId>
    <artifactId>第三方库artifactId</artifactId>
    <version>x.x.x</version>
    <exclusions>
        <!-- 移除对Netty的排除配置 -->
        <!-- <exclusion>
            <groupId>io.netty</groupId>
            <artifactId>*</artifactId>
        </exclusion> -->
    </exclusions>
</dependency>

4. 确认库B的依赖范围 #

检查库B中Azure依赖的<scope>，确保未设置为test或provided（默认compile范围为正确配置）：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-secrets</artifactId>
    <version>4.8.6</version>
    <!-- 不要添加<scope>test</scope>或<scope>provided</scope> -->
</dependency>

你不需要手动引入整个Azure SDK，只需确保Netty依赖能正常传递到项目A即可。库B测试正常是因为测试阶段Maven会将test范围的依赖加入classpath，但运行时只有compile范围的依赖会被传递。

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