Android中Retrofit动态URL场景下MockWebServer拦截失败的解决方案咨询

我之前做项目时也碰到过完全一样的问题——用@Url传动态全量URL、baseUrl设为空，导致MockWebServer根本抓不到请求。结合实际落地的经验，给你几个可行的方案：

方案一：自定义OkHttp拦截器重定向请求到MockWebServer #

这是最灵活且侵入性最低的方案，不用改太多业务代码。核心思路是：在测试环境下，通过OkHttp拦截器捕获所有网络请求，把动态URL替换成MockWebServer的地址，或者直接返回本地Mock数据。

举个代码示例：

class MockRedirectInterceptor(private val mockWebServer: MockWebServer) : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        // 只在测试/debug环境生效，避免影响正式环境
        if (!BuildConfig.DEBUG) {
            return chain.proceed(chain.request())
        }

        val originalRequest = chain.request()
        val originalUrl = originalRequest.url.toString()

        // 这里可以根据原始URL的特征，决定返回对应Mock数据，或者转发到MockWebServer
        val mockRequest = originalRequest.newBuilder()
            .url(mockWebServer.url("/mock-endpoint/")) // 替换成MockWebServer的路径
            .build()

        // 或者直接返回本地JSON文件的内容，不用走MockWebServer
        // val mockJson = loadMockJsonFromAssets("profile_picture.json")
        // return Response.Builder()
        //     .code(200)
        //     .body(ResponseBody.create(MediaType.parse("application/json"), mockJson))
        //     .build()

        return chain.proceed(mockRequest)
    }
}

然后把这个拦截器加到OkHttpClient里：

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(MockRedirectInterceptor(mockWebServer))
    .build()

val retrofit = Retrofit.Builder()
    .baseUrl("") // 保持你的空baseUrl
    .client(okHttpClient)
    .build()

这种方式不管你@Url传什么地址，都能被拦截下来，完全不影响业务代码的写法。

方案二：产品变体+依赖注入切换数据源 #

这就是你提到的思路，我之前在大型项目里用过，适合需要完全隔离真实网络和Mock数据的场景。

1. 定义产品变体：在build.gradle里添加专门的Mock变体（比如mockDebug）：

android {
    flavorDimensions "environment"
    productFlavors {
        production {
            dimension "environment"
        }
        mock {
            dimension "environment"
            buildConfigField "boolean", "USE_MOCK_DATA", "true"
        }
    }
}

2. 抽象数据源接口：把网络请求的逻辑封装到Repository接口里：

interface UserRepository {
    suspend fun getProfilePicture(url: String): ResponseBody
}

3. 实现两种数据源：

   • 真实网络实现（给production变体用）：

   class RemoteUserRepository(private val userService: UserService) : UserRepository {
       override suspend fun getProfilePicture(url: String): ResponseBody {
           return userService.profilePicture(url).execute().body()!!
       }
   }
   

   • Mock本地实现（给mock变体用）：

   class MockUserRepository : UserRepository {
       override suspend fun getProfilePicture(url: String): ResponseBody {
           // 返回本地Mock数据，比如从assets读JSON，或者生成假数据
           val mockJson = """{"image_url": "mock_image_path"}"""
           return ResponseBody.create(MediaType.parse("application/json"), mockJson)
       }
   }
   

4. 依赖注入绑定：用Hilt或者Dagger，根据不同变体绑定不同的Repository实现。比如Hilt的@InstallIn配合变体判断：

@Module
@InstallIn(SingletonComponent::class)
object RepositoryModule {
    @Provides
    fun provideUserRepository(
        userService: UserService
    ): UserRepository {
        return if (BuildConfig.USE_MOCK_DATA) {
            MockUserRepository()
        } else {
            RemoteUserRepository(userService)
        }
    }
}

这样切换变体就能直接用本地Mock数据，完全跳过网络请求，适合UI测试或者快速开发调试。

方案三：改造Retrofit的baseUrl占位技巧 #

其实Retrofit允许baseUrl是一个占位地址，比如http://placeholder.com，然后@Url传完整的动态URL，这时候OkHttp依然能拿到完整的请求URL，拦截器照样可以工作。这种方式不用改太多代码，只是把空baseUrl换成一个无效的占位地址：

val retrofit = Retrofit.Builder()
    .baseUrl("http://placeholder.com") // 占位baseUrl
    .client(okHttpClient)
    .build()

然后你的UserService保持不变，@Url依然传完整URL，拦截器还是能捕获到真实的请求地址，再转发到MockWebServer就行。

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