Quarkus项目如何排除依赖中未使用类及指定JAX-RS扫描范围？

这个问题我之前也碰到过，Quarkus的JAX-RS扫描机制确实容易让开发者踩坑，我来给你拆解一下原因和对应的解决办法：

为什么会出现这个异常？ #

你猜的没错！Quarkus默认会扫描整个classpath中所有带有JAX-RS注解的类（比如@Path、@GET、@POST等），并自动将它们注册为REST资源——哪怕你根本没有在项目中注入或使用这些类。

而Quarkus的CDI"仅打包已使用类"的优化，只针对那些通过CDI注入被引用的类，JAX-RS资源是特殊的：它们属于主动注册的组件，不受CDI的死代码消除逻辑影响。所以这些未被使用的JAX-RS类会被Quarkus实例化，进而触发它们自身的依赖（比如你提到的EJB Bean），而这些依赖在你的项目中没有提供实现，就会抛出Unsatisfied dependency异常。

解决办法 #

1. 限定JAX-RS扫描的包范围 #

最直接的方式是告诉Quarkus只扫描你需要的包，避免扫描依赖中无关的JAX-RS类。在application.properties中添加配置：

# 只扫描你自己项目的REST包，以及依赖中你确实需要用到的JAX-RS类所在的包
quarkus.jaxrs.scan-packages=com.yourproject.rest,com.yourdependency.used-rest-packages

2. 排除特定的JAX-RS类 #

如果不想排除整个包，只想精准排除几个引发问题的类，可以用exclude-classes配置：

# 列出所有需要排除的未使用JAX-RS类的全限定名
quarkus.jaxrs.exclude-classes=com.yourdependency.unused.UnusedRestResource,com.yourdependency.another.UnwantedResource

3. 通用CDI类排除（针对非JAX-RS的未使用类） #

如果还有一些非JAX-RS的CDI/EJB类被错误扫描，你可以通过Quarkus的CDI排除配置来处理：

• 在application.properties中添加：

  # 排除特定类或包下的所有类
  quarkus.cdi.exclude-classes=com.yourdependency.unused.**
  

• 或者创建src/main/resources/META-INF/beans.xml（如果没有的话），通过CDI的原生扫描排除规则配置：

  <beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
         version="2.0">
      <scan>
          <!-- 排除依赖中整个未使用的包 -->
          <exclude name="com.yourdependency.unused.**"/>
          <!-- 也可以单独排除某个类 -->
          <exclude name="com.yourdependency.unused.UnwantedEJBBean"/>
      </scan>
  </beans>
  

4. 验证配置效果 #

修改配置后，你可以启动Quarkus dev模式，查看日志中包含Registered REST resources的条目，确认哪些JAX-RS资源被注册了——如果配置生效，那些未使用的类应该不会出现在这个列表里。

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