Dagger结合Retrofit实现支持用户自定义输入的动态BaseUrl切换

现有尝试方案的失效根因 #

• 调用 retrofit.newBuilder().baseUrl("www.google.com").build() 无法覆盖原有BaseUrl的问题
  失效原因有两个：一是传入的URL不符合Retrofit的硬校验规则——Retrofit要求BaseUrl必须是带完整http/https协议头、且以/结尾的合法网络地址，传入无协议、无结尾斜杠的www.google.com时，内部URL解析逻辑会判定参数非法，直接沿用初始化时设置的原有BaseUrl；二是不少开发者调用newBuilder构建新实例后，仍然使用旧Retrofit实例生成的API Service发起请求，新旧实例配置完全隔离，自然看不到配置生效。
• 使用@Url注解后请求报405 Method not supported的问题
  失效原因不是@Url注解本身不支持动态地址，而是使用时的地址拼接逻辑出错：很多开发者会在接口注解上残留固定路径，或者传入@Url的参数值不是完整全路径，导致请求最终被拼接路由到原BaseUrl下的无效接口地址，触发服务端的方法不支持错误。

正确的动态切换实现路径 #

全局级域名切换（所有接口跟随用户输入的新站点地址） #

这种场景适配用户输入新地址后，应用内所有请求都指向该站点的需求：

• 封装统一的Retrofit实例持有逻辑，禁止业务代码零散创建不受管控的Retrofit实例
• 对用户输入的原始BaseUrl做标准化处理：自动识别补全缺失的http/https协议头，强制在字符串末尾追加/，完全满足Retrofit的BaseUrl格式校验要求
• 收到用户的新BaseUrl配置后，基于原有Retrofit的通用配置（数据转换器、网络拦截器、OkHttpClient实例等）调用newBuilder()，传入标准化的新BaseUrl构建全新Retrofit实例
• 基于新的Retrofit实例重新生成API Service代理对象，替换全局持有引用
  核心注意点：不要复用旧Retrofit实例生成的API Service代理对象发起请求，否则切换不会生效

单接口级任意地址跳转（不依赖全局默认BaseUrl） #

这种场景适配仅需让单个请求跳转到用户输入的任意站点、不强制走全局默认配置的需求：

• 接口方法定义时，搭配对应请求方法注解（@GET/@POST等），不要写固定相对路径，用@Url注解标注传入地址的参数，示例代码：

  @GET
  Call<JsonObject> requestCustomSite(@Url String fullTargetUrl);
  

• 调用接口时，直接传入用户输入的“完整站点地址+对应接口路径”的全量URL，不要额外拼接全局默认的BaseUrl
• 同样需要对用户输入的地址做标准化补全，避免因协议缺失、路径不完整导致请求路由错误

额外注意：如果用户输入的站点是http明文地址，需要在应用的网络安全配置中放开对应域名的明文访问权限，避免系统层面拦截请求导致失败。

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