在 quarkus 的 microprofile rest client 中，当需要调用路径深度动态、含多级斜杠（如 `/json/employees/dwight/jobs/...`）的 rest 接口时，标准 `@pathparam` 会自动对 `/` 进行 url 编码；本文介绍如何通过正则路径匹配（`.+`）安全传递原始路径段，避免编码干扰并确保路由精准匹配。
在 JAX-RS（及 Quarkus 封装的 MicroProfile REST Client）中，路径参数默认以 / 为分隔符进行解析，因此直接传入含斜杠的字符串（如 "employees/Dwight/jobs/assistantRegionalManager/salary"）会导致匹配失败或被错误地 URL 编码为 employees%2FDwight%2F...，进而引发 404 或服务端解析异常。
根本解决方案是使用路径正则表达式（Path Regex）显式声明通配行为：
@Path("/json")
@RegisterRestClient(configKey = "json-api")
public interface JsonService {
@GET
@Path("/{varPath:.+}") // ← 关键：.+, 表示匹配一个或多个任意字符（含 /）
Response getJson(@PathParam("varPath") String endpoint);
}✅ 此写法中：
- {varPath:.+} 的 .+ 是 Java 正则表达式，表示“至少一个任意字符”，明确允许 / 出现在路径段内部；
- JAX-RS 运行时将整个后续路径（如 employees/Dwight/jobs/assistantRegionalManager/salary）作为单个字符串注入 endpoint 参数，不进行额外编码或截断；
- 不依赖 @Encoded（它仅控制参数值是否跳过编码，不改变路径匹配逻辑）；
- 无需拆分为 List
（该类型适用于已知层级的逐段处理，不适用于未知深度的扁平路径）。
⚠️ 注意事项：
- 正则中的 . 默认不匹配换行符，且在路径上下文中不会遇到换行，因此 .+ 安全可靠；
- 避免使用 .*（零或多个），因它可能匹配空字符串，导致 /json/ 被意外接受——而 .+ 要求至少一个字符，语义更严谨；
- 若需进一步约束（例如只允许字母、数字、连字符和斜杠），可用更精确正则，如 {varPath:[a-zA-Z0-9/-]+}，但需确保服务端路由也支持相同规则；
- Quarkus 2.0+ 对 JAX-RS 路径正则支持完善，无需额外配置；旧版本建议升级至 LTS 版本（如 2.13+ 或 3.x）以保障兼容性。
? 实际调用示例：
@Inject
@RestClient
JsonService jsonService;
// 自动发送 GET /json/employees/Dwight/jobs/assistantRegionalManager/salary
Response response = jsonService.getJson("employees/Dwight/jobs/assistantRegionalManager/salary");
// 自动发送 GET /json/games/theLastOfUs/rating
response = jsonService.getJson("games/theLastOfUs/rating");总结：面对无固定层级的动态路径 API，放弃对路径分段的过度结构化假设，转而用 @Path("/{param:.+}") 声明贪婪匹配，是最简洁、标准且 Quarkus 原生支持的实践方案。它既符合 JAX-RS 规范，又规避了客户端编码陷阱，是微服务间灵活集成的关键技巧。
