Retrofit动态BaseUrl配置：解决运行时切换stage/live不生效问题

核心失效原因 #

• 全局单例的Retrofit/OkHttp实例在初始化时，传入的baseUrl是构造期赋值的不可变字段，后续哪怕修改内存里的环境标记，已经构造完成的实例持有的固定地址不会主动更新
• 网络层没有在请求发出的时机实时读取最新的环境地址，大多是初始化时缓存了一次地址，后续不会重新调用地址获取逻辑

落地实现步骤 #

1. 修正环境标记的存储逻辑 #

原有SingleUrlApi直接读取BuildConfig赋值的逻辑只适合默认启动环境，要适配用户自主切换的场景，需要补充两个能力：

• 提供统一的环境更新入口，不要让外部直接修改内存标记
• 把用户选择的环境标记持久化存储，避免应用重启、进程被杀后选择丢失
  调整后的单例类示例：

@Singleton
class SingleUrlApi {
    companion object {
        // 内存缓存当前环境标记，默认值取自BuildConfig，后续从持久化存储加载上次用户选择
        var API_URL_STAGE: Boolean = BuildConfig.STAGE
            private set
        // 下拉控件选择完成后统一调用这个方法更新环境
        fun updateCurrentEnv(isStage: Boolean) {
            API_URL_STAGE = isStage
            // 同步把选中的标记写入SharedPreferences/DataStore做持久化
        }
    }
}

2. 网络层动态获取最新BaseUrl（推荐方案，无需频繁重建实例） #

不要在初始化Retrofit时就传入真实的业务baseUrl，而是通过OkHttp拦截器，在每一次请求发出前，实时调用已有的getUrl()方法读取最新的环境地址，替换请求的目标地址：

• 初始化Retrofit时传入一个合法格式的占位baseUrl（比如https://placeholder.example.com/），因为真实地址会在拦截器层替换
• 给OkHttpClient添加自定义的BaseUrl替换拦截器，参考实现：

class EnvSwitchInterceptor(
    private val urlProvider: UrlProvider // 即实现getUrl方法的类实例
) : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        val originRequest = chain.request()
        // 每次请求都实时取最新的API基础地址，不做缓存
        val currentBaseUrl = urlProvider.getUrl(ShopUrl.API_BASE).toHttpUrl()
        // 基于原请求的路径，替换scheme、host、port为当前最新环境的地址
        val newRequestUrl = originRequest.url.newBuilder()
            .scheme(currentBaseUrl.scheme)
            .host(currentBaseUrl.host)
            .port(currentBaseUrl.port)
            .build()
        val newRequest = originRequest.newBuilder()
            .url(newRequestUrl)
            .build()
        return chain.proceed(newRequest)
    }
}

• 把这个拦截器关联到全局的OkHttpClient实例上即可，用户切换环境时只要正常更新SingleUrlApi里的环境标记，后续发出的所有请求都会自动走最新的地址

3. 备选实现方案：切换环境时主动重建网络单例 #

如果不想引入拦截器，也可以在用户切换环境的回调里，手动触发：

• 清空原有Retrofit、Api服务类的单例引用
• 用最新的baseUrl重新构造全局单例的网络栈
  这个方案需要注意两个细节：
• 要同步取消所有未完成的旧请求，避免请求走到旧环境的地址
• 所有依赖Retrofit实例的注入对象、单例都要同步更新引用，防止还持有旧实例发请求

常见注意事项 #

• 所有网络接口的注解（@GET/@POST等）只写相对路径，不要写完整url，否则会导致拦截器替换地址时路径匹配异常
• WebView加载内部H5页面时，要在加载前实时调用getUrl(ShopUrl.WEB_BASE)取最新的Web基础地址，不要使用之前缓存的地址字符串
• 切换环境后及时清理对应环境的网络响应缓存，避免读取到旧环境的接口缓存数据

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