Knex查询中TypeScript泛型出现[Symbol.iterator()]错误及.first()问题求助

第一个错误原因 #

你写的const [user]: T = await db("users").insert(data).returning("*");里，T是单个用户对象的类型，但insert().returning("*")返回的是数组类型（T[]）。解构语法要求等号右侧是可迭代对象（比如数组），而T是单个对象，不具备迭代器方法，所以TypeScript抛出错误。

第二个错误原因 #

你调用.first()的顺序错了——Knex中first()需要放在returning("*")之后，因为returning()返回的是包含插入结果的数组查询，first()的作用是从这个结果数组中取出第一个元素。另外，没有给Knex查询指定明确的泛型，导致返回类型被推断为any[]，无法匹配你定义的T类型。

解决方法 #

方法1：正确使用解构 #

给db方法指定泛型T（你的用户类型），让TypeScript自动推断返回数组的类型：

// 先定义你的用户类型
interface User {
  id: number;
  name: string;
  email: string;
}

// 解构获取第一个元素，类型会被推断为 User | undefined
const [user] = await db<User>("users").insert(data).returning("*");

// 如果能确保插入成功且必有返回值，可添加非空断言
const safeUser = user!;

方法2：正确使用.first() #

调整first()的调用位置，放在returning()之后，同时指定泛型：

const user = await db<User>("users").insert(data).returning("*").first();

// 同样，若需确保非空，添加非空断言
const safeUser = await db<User>("users").insert(data).returning("*").first()!;

额外提示 #

• 泛型T必须准确对应你的users表结构，避免类型不匹配。
• 如果你使用的是Knex@0.95+版本，泛型支持更完善，建议升级到最新稳定版。

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