Android Room使用TypeConverter时报must receive 1 parameter错误求助

云原生阿岚

2026-9-29

问题根因

你对Room的@TypeConverter作用存在完全误用，两个报错的触发逻辑如下：

第二个报错Type converters must receive 1 parameter是@TypeConverter的强制规则：类型转换器的作用是实现自定义类型 ↔ SQLite支持的基础存储类型（String/Int/Boolean等）的互相转换，仅用于实体类字段的序列化/反序列化，要求每个转换方法只能有1个入参，你写的getAllQuery有2个入参，不符合规则直接触发校验报错。
你最开始的第一个报错和@TypeConverter毫无关系，是你DAO层接收SimpleSQLiteQuery的查询方法用错了注解：动态SQL查询要配合@RawQuery注解使用，你当时应该是给方法加了@Query注解，Room识别不了SupportSQLiteQuery类型的参数才提示你加类型转换器。

修复步骤

删除错误的注解配置
去掉getAllQuery方法上的@TypeConverter注解，同时把这个类从数据库类声明的@TypeConverters()括号里移除，这个方法是用来生成动态SQL的工具方法，和类型转换完全无关。

修正DAO层动态查询方法的写法
补充你没贴全的DAO层getAll方法，必须使用@RawQuery注解，示例如下：

// 注意这里用@RawQuery而不是@Query，observedEntities指定关联的表保证数据变更能通知到LiveData
@RawQuery(observedEntities = [Tea::class])
fun getAll(query: SupportSQLiteQuery): DataSource.Factory<Int, Tea>

如果你确实需要用TypeConverter，遵循单入参规则
比如你需要把TeaSortBy枚举作为字段存到Tea实体里，正确的TypeConverter写法示例：
```
class TeaTypeConverter {
    @TypeConverter
    fun sortByToString(sortBy: TeaSortBy): String = sortBy.name
    
    @TypeConverter
    fun stringToSortBy(name: String): TeaSortBy = TeaSortBy.valueOf(name)
}
```
只有这类用于单类型互相转换的方法才需要加@TypeConverter，注册到数据库的@TypeConverters配置里。