迁移Resteasy jaxrs 3到client 4报RESTEASY003720如何修复

这个错误是RESTEasy 4相较于3版本收紧路径参数校验规则导致的，和你配置的基础URLlocalhost:8080没有直接关联，按以下步骤排查即可：

排查步骤 #

• 核对所有层级@Path注解的占位符和@PathParam映射：检查接口类上、方法上的@Path定义里所有{参数名}格式的占位符，都必须有对应同名的@PathParam("参数名")标注在方法入参上。RESTEasy 3对参数名不匹配、漏注解的场景会做静默兼容，自动跳过未匹配的占位符，4版本会在构建请求路径的阶段直接抛出该错误，不会继续执行。
• 检查路径参数的传值：调用代理客户端方法时，所有被@PathParam标记的入参不能传null，3版本会自动把null转成空字符串拼接路径，4版本默认将null判定为参数未提供直接抛错。
• 确认基础URL格式：你当前配置的localhost:8080缺少协议头，不符合URI规范，需要改成http://localhost:8080，这个问题不会直接触发当前报错，但会导致后续请求发送失败，需要一并修正。

修复方案 #

• 修正参数映射错误：保证@Path中占位符的字符串和@PathParam注解的value完全一致，不要出现拼写错误、下划线/驼峰不匹配的问题；如果方法入参没有加@PathParam注解要补上，4版本默认不会自动读取方法形参名匹配占位符，不要依赖编译参数保留形参名的隐式匹配逻辑。
• 补全路径参数传值：如果路径段是固定值，直接写在@Path里即可，不要写成{xxx}格式的占位符；如果是动态参数，调用方法时必须传入非null的有效值。
• 老逻辑兼容配置：如果项目有大量历史逻辑依赖3版本null参数自动拼接的行为，可以在构建ResteasyClient时添加配置resteasy.client.nullAsPathParam = true临时兼容，不建议长期开启该配置，会隐藏路径拼接的逻辑错误。

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