Okhttp 3如何按名称获取路径参数并动态添加请求头

Okhttp作为底层HTTP客户端，本身不感知上层Retrofit通过@Path注解定义的命名路径参数。当请求到达Okhttp拦截器层时，Retrofit已经将路径模板中的{xxx}占位符全部替换为实际值，不会保留「参数名-参数值」的映射关系，因此不存在原生的getPathParam()类方法可以直接按名称提取路径参数，这也是公开资料中找不到对应原生实现的核心原因。

针对不依赖路径段索引、按名称获取serviceId参数并动态生成token添加请求头的需求，可参考以下落地实现：

方案1：通过Retrofit自带的Invocation元信息提取参数（无侵入、最稳定） #

Retrofit 2.6及以上版本默认会将当前接口调用的方法元信息、所有传入实参封装为Invocation对象，自动设置为OkHttp Request的tag，不需要额外自定义注解或修改接口定义，即可在拦截器中直接获取所有@Path标注的参数值。
Retrofit接口定义沿用现有写法即可：

@POST("services/{serviceId}/resources/{resourceId}")
Call<Resource> addResourceVector(@Path("serviceId") Long serviceId,
                                 @Path("resourceId") String resourceId)

拦截器逻辑实现参考：

public class AuthHeaderInterceptor implements Interceptor {

    private final TokenService tokenService;

    public AuthHeaderInterceptor(TokenService tokenService) {
        this.tokenService = tokenService;
    }

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request originalRequest = chain.request();
        Request.Builder requestBuilder = originalRequest.newBuilder();

        // 提取Retrofit自动注入的调用元信息
        Invocation invocation = originalRequest.tag(Invocation.class);
        if (invocation != null) {
            Parameter[] methodParams = invocation.method().getParameters();
            List<Object> argValues = invocation.arguments();
            Long targetServiceId = null;

            // 遍历查找@Path("serviceId")对应的参数值
            for (int i = 0; i < methodParams.length; i++) {
                Path pathAnno = methodParams[i].getAnnotation(Path.class);
                if (pathAnno != null && "serviceId".equals(pathAnno.value())) {
                    targetServiceId = (Long) argValues.get(i);
                    break;
                }
            }

            if (targetServiceId != null) {
                requestBuilder.header(HttpHeaders.AUTHORIZATION, "对应serviceId的token值");
            }
        }

        return chain.proceed(requestBuilder.build());
    }
}

注意：不要在拦截器逻辑中直接阻塞调用CompletableFuture.get()获取token。由于OkHttp未采纳异步拦截器提案，拦截器逻辑全程同步执行，阻塞会导致线程卡死、死锁问题。建议配合自定义CallAdapter，在请求进入OkHttp前提前异步完成token获取，再注入请求。

针对TokenService.getToken()返回CompletableFuture的场景，可自定义Retrofit CallAdapter，在请求分发到OkHttp之前先异步等待token加载完成，再将token写入请求头，从根源上避免同步阻塞问题。

方案2：路径模板正则匹配（无需修改Retrofit配置） #

如果不想调整Retrofit相关配置，可以提前收集所有接口的路径模板，为每个模板生成对应带命名分组的正则表达式，在拦截器中用正则匹配实际请求路径，按分组名提取对应参数值。
例如针对路径模板services/{serviceId}/resources/{resourceId}，可生成正则规则services/(?<serviceId>[^/]+)/resources/(?<resourceId>[^/]+)，匹配成功后即可直接通过分组名拿到serviceId的实际值。这种方案同样不依赖路径段的固定索引位置，但需要维护路径模板和正则的映射关系，适合接口规模较小的项目使用。

不推荐的实现方式 #

• 按固定路径段索引提取参数：强依赖路径的固定结构，只要接口版本迭代、路径层级调整就会直接失效，维护成本极高。
• 应用启动时预取token全局复用：无法满足按不同serviceId动态生成对应token的需求，且token过期刷新逻辑复杂度高。

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