Quarkus报jakarta.ws.rs.NotFoundException：无法匹配目标资源方法

这个jakarta.ws.rs.NotFoundException错误的核心是Resteasy Reactive框架无法匹配到对应请求的资源处理方法，常见触发原因如下：

1. 接口类缺少类级@Path注解 #

你的方法上标注了方法级@Path("/{companyId}/details")，但如果整个接口类没有添加类级别的@Path注解，框架无法识别这是一个JAX-RS资源类，也就无法将请求路由到该方法。正确的接口类应该包含基础路径注解：

@Path("/companies") // 类级基础路径，与方法级路径拼接成完整路由
public interface CompanyResource {
    // 你的getDetailsCompanyById方法
}

2. 请求路径/方法与定义不匹配 #

• 确认请求使用的是GET方法，而非POST/PUT等其他HTTP方法
• 检查完整请求路径是否与定义一致：类级@Path + 方法级@Path，比如类级是/companies，则完整路径应为/companies/{companyId}/details
• 验证companyId参数是有效的UUID格式：框架会自动尝试将路径参数转换为UUID类型，格式错误可能导致路由匹配失败（部分场景下会触发400，但也可能直接导致路由找不到）

3. 实现类未正确注册为资源 #

如果你的实现类没有添加CDI注解（比如Quarkus环境下的@ApplicationScoped），框架无法实例化并管理这个类，自然找不到对应的处理方法。实现类需要类似这样的注解：

@ApplicationScoped
public class CompanyResourceImpl implements CompanyResource {
    // 你的实现方法
}

4. 路径大小写或特殊字符问题 #

JAX-RS路径匹配默认大小写敏感，检查请求路径是否与定义完全一致（比如接口是/details，请求用了/Details）；同时确认companyId参数没有包含框架无法解析的特殊字符。

5. 依赖缺失或版本不兼容 #

如果使用Quarkus + Resteasy Reactive，确保已正确引入相关依赖（比如quarkus-resteasy-reactive-jackson），缺失核心依赖可能导致资源类无法被框架正确识别。

内容的提问来源于stack exchange，提问作者Lewis Florez R