JAX RS 3.0为何在请求错误场景抛出404？参数差异原因何在？

这个设计本质是严格遵循HTTP状态码的语义，把资源定位相关的错误和请求格式本身的错误做了明确区分，背后是对"资源标识"和"请求元数据"边界的清晰界定：

• URL参数是资源标识的核心组成部分
  @PathParam、@QueryParam、@MatrixParam这些参数，本质是用来唯一标识或筛选特定资源的。比如/users/{userId}里的userId是资源路径的一部分，如果解析失败（比如预期是数字却传了非数字字符串），意味着客户端请求的/users/abc这个资源根本不存在——服务器找不到对应路径的资源，返回404 NotFound完全符合HTTP语义。
  再比如/products?category=xxx的@QueryParam，要是category参数解析失败（比如预期是枚举值却传了非法值），相当于客户端请求的"属于非法分类的商品集合"这个资源不存在，同样归为资源未找到的场景。

• 元参数是请求的附属信息，不影响资源定位
  @HeaderParam和@CookieParam属于请求的元数据，用来告诉服务器如何处理请求（比如授权信息、客户端偏好），而非用来定位资源。如果这些参数解析失败，说明请求本身的格式或内容不符合要求——比如Authorization头格式错误、Cookie值不符合约定，这是客户端发送的请求本身有问题，而非目标资源不存在，所以返回400 BadRequest才是正确的语义。

规范这么制定，是为了让客户端能通过状态码快速区分两类错误：收到404时，客户端应该检查自己请求的资源路径/筛选条件是否正确；收到400时，则需要检查请求头、Cookie等元数据的格式是否符合服务器要求。

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