Gradle升级至8.3.4后Room类型转换器识别异常求助

在Gradle 8.0.0环境下，Room数据库配合自定义CommonConverter可正常工作，Dao实现文件能正常生成。但升级到Gradle 8.3.4后，出现如下错误：

Cannot figure out how to save this field into database. You can consider adding a type converter for it. private error.NonExistentClass ecgData;

对应实体类字段代码：

@ColumnInfo(name = DBConstants.COL_ECG_DATA)
@SerializedName(DBConstants.COL_ECG_DATA)
var ecgData: ArrayList<String>? = null

AppDatabase定义：

@TypeConverters(CommonConverter::class)
abstract class AppDatabase : RoomDatabase() {}

CommonConverter中已包含ArrayList<String>的转换方法：

@TypeConverter
public static ArrayList<String> toArrayListString(String value) {
    Type objType;
    try {
        objType = new TypeToken<ArrayList<String>>() {
        }.getType();
        return new Gson().fromJson(value, objType);
    } catch (Exception e) {
        Logger.warn(TAG, e.getMessage());
    }
    return new ArrayList<>();
}

@TypeConverter
public static String fromArrayListString(ArrayList<String> value) {
    return new Gson().toJson(value);
}

解决方案 #

1. 匹配Room与Gradle版本兼容性 #

Gradle 8.3.4需要适配对应版本的Room组件，确保room-runtime、room-compiler、room-ktx等依赖版本一致且兼容Gradle 8.x，建议使用Room 2.5.0及以上稳定版本（如2.6.1）。修改Module级build.gradle：

dependencies {
    def room_version = "2.6.1"
    implementation "androidx.room:room-runtime:$room_version"
    kapt "androidx.room:room-compiler:$room_version"
    implementation "androidx.room:room-ktx:$room_version"
}

2. 修复类型转换器的静态修饰符 #

检查CommonConverter中所有@TypeConverter注解的方法，确保均为public static（Java类要求）。当前toStringMap和fromStringMap方法缺少static修饰符，需补充：

@TypeConverter
public static String fromStringMap(HashMap<String, String> value) {
    try {
        final Map<String, String> sortedMap = new TreeMap<>(value);
        return TextUtils.join(",", sortedMap.keySet())
                .concat("<divider>")
                .concat(TextUtils.join(",", sortedMap.values()));
    } catch (Exception e) {
        Logger.warn(TAG, e.getMessage());
    }
    return null;
}

@TypeConverter
public static HashMap<String, String> toStringMap(String value) {
    try {
        final String[] keysValsSep = value.split("<divider>");
        final String[] keys = keysValsSep[0].split(",");
        final Iterator<String> valuesIterator = Arrays.asList(keysValsSep[1].split(",")).iterator();
        final HashMap<String, String> strMap = new HashMap<>();

        for (String key : keys) {
            strMap.put(key, valuesIterator.next());
        }
        return strMap;
    } catch (Exception e) {
        Logger.warn(TAG, e.getMessage());
    }
    return null;
}

3. 显式在实体类上绑定TypeConverter #

若数据库级别的@TypeConverters未被正确识别，可直接在包含ecgData字段的实体类上添加注解，确保Room能定位到转换规则：

@Entity(tableName = DBConstants.TABLE_NAME)
@TypeConverters(CommonConverter::class)
data class YourEntity(
    // 其他字段
    @ColumnInfo(name = DBConstants.COL_ECG_DATA)
    @SerializedName(DBConstants.COL_ECG_DATA)
    var ecgData: ArrayList<String>? = null
)

4. 清理缓存并重新构建 #

Gradle升级后可能存在缓存冲突，执行以下操作：

• 点击Android Studio的Build -> Clean Project
• 点击Build -> Rebuild Project
• 或命令行执行：./gradlew clean build

5. 确保KAPT插件已启用 #

检查Module级build.gradle，确认添加了KAPT插件（Room注解处理器依赖此插件）：

plugins {
    id 'com.android.application'
    id 'kotlin-android'
    id 'kotlin-kapt' // 确保此插件存在
}

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