使用Room所遇到的 Execution failed for task ‘:app:kaptDebugKotlin‘

路径窄处，留一步让人走；
滋味浓时，减三分请人尝。

---

1. 踩雷

项目中使用Room数据库，需要新增操作方法然后就对相应的Dao进行了一些修改,结果是这样的：

Execution failed for task ':app:kaptReleaseKotlin'.
> A failure occurred while executing org.jetbrains.kotlin.gradle.internal.KaptExecution
   > java.lang.reflect.InvocationTargetException (no error message)

尼玛哦，no error message 显得辣么鲜艳夺目，光彩照人啊…

---

2. 排雷

StackOverflow的方案 这次是真指望不上啦。

毛主席教育我们: 自己动手,丰衣足食。那就捋起袖子加油干…

一般情况下，遇到build过程中出现的错误，我们的正确姿势是这样的。

1. 打开Android Studio 右侧的Gradle；
2. 找到对应模块下的build，进行build等相关操作；

如下图所示:

这里双击build之后,详细信息就出来啦,极其方便地帮助我们定位到问题。

错误: Not sure how to convert a Cursor to this method’s return type (void).

---

3. 总结

根据上面的错误定位，很容易就把问题给解决掉啦…

错误原因：

SELECT 查询是需要有返回值的。默认返回Cursor。

文档描述如下：

For SELECT queries, Room will infer the result contents from the method’s return type and generate the code that will automatically convert the query result into the method’s return type. For single result queries, the return type can be any data object (also known as POJOs). For queries that return multiple values, you can use List or Array. In addition to these, any query may return Cursor or any query result can be wrapped in a LiveData.

INSERT queries can return void or long. If it is a long, the value is the SQLite rowid of the row inserted by this query. Note that queries which insert multiple rows cannot return more than one rowid, so avoid such statements if returning long.

UPDATE or DELETE queries can return void or int. If it is an int, the value is the number of rows affected by this query.

简单总结一下：

1. SELECT 查询：任何查询都可以返回Cursor 或者 LiveData包装后的结果。
   1. 单个结果查询：直接返回数据对象(POJOs)
   2. 多个结果查询: 可以使用List 或者 Array
2. INSERT 查询: 无返回值(void)或者long(行号rowid)
3. UPDATE 和 DELETE 查询: 无返回值(void) 或者int(受影响的行数)

详细文档地址:Query

---

4. Room相关知识

1. Room 持久性库
2. 使用 Room 将数据保存到本地数据库
3. Room API 文档

---

考虑抽出时间，专门来写一下Room