ViewBinding搭配Lifecycle/LiveData/ViewModel使用报错咨询

你遇到的崩溃和ViewBinding替换废弃的Kotlin Extensions没有关联，从错误堆栈可以直接定位根因：构建Retrofit实例时没有配置合法的BaseUrl，触发java.lang.IllegalStateException: Base URL required异常，出错位置是di/module/HomeModule.kt第25行的provideRetrofit方法。

1. 先修复Retrofit初始化错误 #

Retrofit强制要求配置非空、格式符合规范的baseUrl才允许构建实例，两个最常见的配置错误：

• 完全漏写.baseUrl()配置项
• 传入的baseUrl为空、或末尾没有携带/（Retrofit对url格式有强校验，不符合规则就会抛出异常）

推荐把接口配置放到BuildConfig中统一管理，避免硬编码：
首先在Module级别的build.gradle中开启对应配置：

android {
    namespace "id.kotlin.belajar"
    compileSdk 33

    defaultConfig {
        applicationId "id.kotlin.belajar"
        minSdk 21
        targetSdk 33
        versionCode 1
        versionName "1.0"

        // 配置moviedb接口地址和你自己申请的API Key
        buildConfigField "String", "API_BASE_URL", "\"https://api.themoviedb.org/3/\""
        buildConfigField "String", "MOVIE_DB_KEY", "\"替换为你自己申请的moviedb API Key\""
    }

    buildFeatures {
        // 开启ViewBinding，不需要额外引入废弃的kotlin-extensions插件
        viewBinding true
        buildConfig true
    }
    // 其他配置项省略
}

之后修改HomeModule.kt中的Retrofit提供方法：

@Module
class HomeModule {
    companion object {
        @Provides
        @Singleton
        fun provideRetrofit(okHttpClient: OkHttpClient): Retrofit {
            return Retrofit.Builder()
                .baseUrl(BuildConfig.API_BASE_URL) // 必须配置，值必须以/结尾
                .client(okHttpClient)
                .addConverterFactory(GsonConverterFactory.create())
                .build()
        }
        // 其他OkHttp、ApiService、DataSource的提供方法保持原有逻辑即可
    }
}

2. ViewBinding + Lifecycle/ViewModel/LiveData 标准写法 #

不需要引入任何额外插件，开启viewBinding = true后，Android Studio会自动为每个布局文件生成对应的Binding类，命名规则为布局文件名驼峰转写+Binding后缀，比如activity_home.xml对应生成ActivityHomeBinding。

Activity层写法 #

class HomeActivity : AppCompatActivity() {
    // 懒加载ViewModel，如果使用自定义ViewModelFactory，把工厂实例作为参数传入viewModels()
    private val viewModel: HomeViewModel by viewModels { ViewModelFactory }
    // 延迟初始化ViewBinding实例
    private lateinit var binding: ActivityHomeBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 初始化Binding，替代原有的setContentView(R.layout.activity_home)
        binding = ActivityHomeBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 观察LiveData数据，生命周期安全，页面销毁时自动取消订阅，不会内存泄漏
        viewModel.movieList.observe(this) { movieList ->
            // 直接通过binding引用控件，不需要findViewById，也不需要kotlin-extensions的合成属性
            // 示例：binding.movieRv.adapter = MovieAdapter(movieList)
        }

        viewModel.loadError.observe(this) { errorMsg ->
            Toast.makeText(this, errorMsg, Toast.LENGTH_SHORT).show()
        }

        // 触发页面数据加载
        viewModel.fetchPopularMovies()
    }
}

ViewModel层写法 #

注意：ViewModel绝对不能持有Activity、View、Binding类的引用，避免生命周期不一致导致内存泄漏

class HomeViewModel(private val homeDataSource: HomeDatasource) : ViewModel() {
    // 内部使用可修改的MutableLiveData，对外暴露不可变的LiveData给页面观察
    private val _movieList = MutableLiveData<List<Movie>>()
    val movieList: LiveData<List<Movie>> = _movieList

    private val _loadError = MutableLiveData<String>()
    val loadError: LiveData<String> = _loadError

    fun fetchPopularMovies() {
        // 使用viewModelScope发起协程请求，页面销毁时自动取消协程，不需要手动管理生命周期
        viewModelScope.launch {
            try {
                val response = homeDataSource.getPopularMovies(BuildConfig.MOVIE_DB_KEY)
                if (response.isSuccessful) {
                    _movieList.postValue(response.body()?.results ?: emptyList())
                } else {
                    _loadError.postValue("请求失败，错误码：${response.code()}")
                }
            } catch (e: Exception) {
                _loadError.postValue("网络异常：${e.localizedMessage}")
            }
        }
    }
}

3. 依赖校验 #

确保build.gradle中引入的是最新稳定版依赖，不要引入已废弃的kotlin-extensions相关依赖：

dependencies {
    // 基础AndroidX依赖
    implementation 'androidx.core:core-ktx:1.8.0'
    implementation 'androidx.appcompat:appcompat:1.5.0'
    implementation 'com.google.android.material:material:1.6.1'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'

    // Lifecycle、ViewModel、LiveData 核心依赖
    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.5.1'
    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.5.1'
    implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.5.1'

    // 网络请求相关依赖
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
    implementation 'com.squareup.okhttp3:okhttp:4.10.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.10.0'
}

• ViewBinding生成的Binding类必须通过inflate方法初始化，传入layoutInflater，之后把binding.root传给setContentView才能正常使用
• LiveData观察数据时必须传入正确的LifecycleOwner（Activity/Fragment本身），不要传入全局生命周期，避免页面销毁后仍执行UI操作导致崩溃
• Retrofit的baseUrl必须以/结尾，否则会抛出格式校验异常
• ViewModel作用域只处理数据逻辑，所有UI操作必须放到Activity/Fragment层观察LiveData后执行

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