Retrofit实现用户自定义动态Base URL的方案咨询

不建议长期沿用「占位Base URL + 全接口@URL传全路径」的方案。
你对@URL注解的认知存在一点偏差：实际上@URL支持PUT、DELETE、PATCH等所有Retrofit兼容的请求方法，并非仅支持GET和POST，但这种方案要求你在每一个接口调用时都传入完整请求地址，维护成本极高，一旦接口路径调整需要修改所有调用点，非常容易出现漏改、错写路径的问题，完全不是最优解。

方案1：用户完成配置后再创建/更新Retrofit实例（最推荐，实现成本最低） #

你完全不需要在App启动阶段就强行初始化全局固定的Retrofit单例，完全可以按照业务流程走：

• App启动时先检查本地是否已经存储了用户配置的合法服务器地址，做格式校验（补全http/https前缀、校验IP/域名格式、确认末尾带路径分隔符/）
• 如果没有有效配置，直接跳转到服务器地址输入页，等用户输入完成、校验通过后，再用这个真实的Base URL创建Retrofit实例，交给全局管理类或者依赖注入框架持有
• 后续如果用户在设置页修改了服务器地址，直接废弃旧的Retrofit实例，用新的Base URL创建新实例替换即可
  这种方案下你所有的接口定义都可以正常写相对路径，不需要加任何额外注解，也不需要额外的拦截逻辑，性能最好，毕竟用户修改服务器地址是极低频率的操作，重建Retrofit实例的开销完全可以忽略。

方案2：OkHttp拦截器动态替换Base URL（适合需要频繁切换地址的场景） #

如果你不想在用户修改地址时重建Retrofit实例，可以通过OkHttp拦截器实现运行时动态替换Base URL，不需要改动任何接口定义。

实现步骤 #

1. 初始化Retrofit时传入一个符合URL规范的占位地址即可（必须带http/https前缀、末尾带/，否则Retrofit初始化会抛异常）
2. 给OkHttpClient添加自定义拦截器，在拦截器中读取用户当前配置的真实服务器地址，替换请求的域名、协议、端口信息即可

核心代码示例 #

动态Base URL拦截器实现：

public class DynamicBaseUrlInterceptor implements Interceptor {
    @NotNull
    @Override
    public Response intercept(@NotNull Chain chain) throws IOException {
        Request originalRequest = chain.request();
        // 从本地配置缓存中读取用户输入的真实服务器地址，提前做好格式校验
        String realBaseUrl = ServerConfigManager.get().getCurrentUserBaseUrl();
        if (realBaseUrl == null || realBaseUrl.isEmpty()) {
            throw new IOException("请先配置专属服务器地址");
        }
        HttpUrl parsedRealUrl = HttpUrl.parse(realBaseUrl);
        if (parsedRealUrl == null) {
            throw new IOException("服务器地址格式非法，请重新输入");
        }
        // 替换请求的协议、域名、端口为真实服务器配置
        HttpUrl newRequestUrl = originalRequest.url().newBuilder()
                .scheme(parsedRealUrl.scheme())
                .host(parsedRealUrl.host())
                .port(parsedRealUrl.port())
                // 如果你的服务器地址有统一路径前缀（比如https://ip:port/api/），可以在这里补充替换对应路径段
                .build();
        Request newRequest = originalRequest.newBuilder()
                .url(newRequestUrl)
                .build();
        return chain.proceed(newRequest);
    }
}

初始化Retrofit时注册拦截器：

OkHttpClient httpClient = new OkHttpClient.Builder()
        .addInterceptor(new DynamicBaseUrlInterceptor())
        .build();

return new Retrofit.Builder()
        .baseUrl("http://placeholder.local/") // 仅作为格式合法的占位符使用，不会真的发起请求
        .client(httpClient)
        .build();

• 普通场景直接选方案1即可，代码最简洁，没有额外运行时逻辑，出问题的概率最低
• 如果你的应用有频繁切换多套服务器地址的需求（比如同时支持用户私有服务器、官方测试服、官方正式服随时切换），再考虑用方案2
• @URL注解只适合极个别需要请求非当前Base URL域名的特殊接口，不要全项目所有接口都用这种方式传全路径

内容的提问来源于stack exchange，提问作者Мартин Симов