Room数据库迁移报错排查及多表管理Fragment/Adapter优化咨询

一、Room版本迁移报错解决 #

1. 开发阶段临时方案 #

如果是测试阶段无需保留旧数据，可直接让Room重建数据库，规避迁移检查：

Room.databaseBuilder(context, AppDatabase::class.java, "your-db-name")
    .fallbackToDestructiveMigration()
    .build()

2. 正式环境迁移实现 #

若需保留数据，必须编写对应版本的迁移逻辑：

• 确认@Database注解中的version字段已从1升级为2
• 创建版本1到2的Migration类，准确对应Schema变更（比如新增字段、表结构调整）：

val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 示例：给cars表新增color字段
        database.execSQL("ALTER TABLE cars ADD COLUMN color TEXT")
    }
}

• 在数据库构建时注入迁移逻辑：

Room.databaseBuilder(context, AppDatabase::class.java, "your-db-name")
    .addMigrations(MIGRATION_1_2)
    .build()

提示：可在app模块的build.gradle中开启Schema生成，查看版本间具体的结构差异：

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments += ["room.schemaLocation": "$projectDir/schemas".toString()]
            }
        }
    }
}

二、Adapter与Fragment简化方案 #

1. 单一职责的Adapter改造 #

禁止让Adapter同时处理多数据集，每个Adapter只负责一种数据类型：

• 针对cars表单独实现CarAdapter，仅接收List<Car>作为数据源：

class CarAdapter(private var carList: List<Car>) : RecyclerView.Adapter<CarAdapter.CarViewHolder>() {

    inner class CarViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        private val carNameTv: TextView = itemView.findViewById(R.id.tv_car_name)
        fun bind(car: Car) {
            carNameTv.text = car.name
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): CarViewHolder {
        val itemView = LayoutInflater.from(parent.context).inflate(R.layout.item_car, parent, false)
        return CarViewHolder(itemView)
    }

    override fun onBindViewHolder(holder: CarViewHolder, position: Int) {
        holder.bind(carList[position])
    }

    override fun getItemCount() = carList.size

    // 添加数据更新方法，避免重复创建Adapter
    fun updateData(newCars: List<Car>) {
        this.carList = newCars
        notifyDataSetChanged()
        // 追求性能可替换为DiffUtil实现局部更新
    }
}

• 若需关联跨表数据（如Car对应Customer），在ViewModel层提前合并为CarWithCustomer数据类，再传递给Adapter，避免Adapter处理业务逻辑。

2. Fragment逻辑轻量化 #

（1）用ViewModel隔离数据操作

将数据库查询、插入等逻辑迁移至ViewModel，Fragment仅负责UI渲染和交互：

class CarViewModel(application: Application) : AndroidViewModel(application) {
    private val carDao = AppDatabase.getInstance(application).carDao()
    val allCars: LiveData<List<Car>> = carDao.getAllCars()

    fun insertCar(car: Car) {
        viewModelScope.launch {
            carDao.insert(car)
        }
    }
}

（2）Fragment极简实现

Fragment只做UI初始化、观察LiveData、处理录入事件：

class CarManagerFragment : Fragment() {
    private lateinit var viewModel: CarViewModel
    private lateinit var carAdapter: CarAdapter

    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        val view = inflater.inflate(R.layout.fragment_car_manager, container, false)
        
        // 初始化RecyclerView
        val recyclerView = view.findViewById<RecyclerView>(R.id.car_recycler)
        carAdapter = CarAdapter(emptyList())
        recyclerView.apply {
            adapter = carAdapter
            layoutManager = LinearLayoutManager(context)
        }

        // 绑定ViewModel并观察数据
        viewModel = ViewModelProvider(this)[CarViewModel::class.java]
        viewModel.allCars.observe(viewLifecycleOwner) { cars ->
            carAdapter.updateData(cars)
        }

        // 处理录入逻辑
        val carNameEt = view.findViewById<EditText>(R.id.et_car_name)
        view.findViewById<Button>(R.id.btn_add_car).setOnClickListener {
            val carName = carNameEt.text.toString().trim()
            if (carName.isNotEmpty()) {
                viewModel.insertCar(Car(name = carName))
                carNameEt.text.clear()
            }
        }
        return view
    }
}

3. 通用逻辑复用 #

三个Fragment的录入UI可封装为自定义View（如DataInputView），包含EditText和提交按钮，减少重复布局和点击事件代码。

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