TypeScript中使用Knex.js实现指定列INSERT插入操作的方法

核心说明 #

你当前的写法本身不需要显式指定列也可以生成符合预期的INSERT语句，代码无法运行大概率不是未指定列的问题，常见诱因有以下几点：

• 传入的插入对象中存在undefined值：如果recipe.getId()/getTittle()/getDescription()任意一个返回undefined，Knex会将其转换为NULL，触发这三个字段的非空约束报错
• 错误捕获写法丢失原始报错信息：原代码中throw new Error(error)会覆盖原始错误的错误码、堆栈信息，导致无法定位真实报错原因
• 数据库账号缺少recipes表的INSERT权限，或Knex连接配置异常

如果需要完全对齐你手写的显式指定列的SQL逻辑，可以通过.columns()链式方法显式声明要插入的字段列表，Knex生成的SQL会和你手写的完全一致，自动忽略表中带默认值、未在列列表中声明的creation_date字段，使用数据库配置的默认值填充。

可直接运行的正确代码 #

export class RecipesDataBase extends BaseDataBase {
    public async createRecipe(recipe: Recipes) {
        try {
            await BaseDataBase.connection("recipes")
                // 显式指定插入列，和手写SQL的字段列表完全对齐
                .columns(["id", "tittle", "description", "user_id"])
                .insert({
                    id: recipe.getId(),
                    tittle: recipe.getTittle(),
                    description: recipe.getDescription(),
                    user_id: recipe.getUserId(),
                })
        } catch (error: any) {
            // 直接抛出原始错误，保留错误栈和错误码方便排查
            throw error
        }
    }
}

问题排查技巧 #

如果修改后依然报错，可以在Knex调用链上加上.debug()方法，打印实际生成运行的SQL语句，和你预期的手写SQL做对比即可快速定位问题：

await BaseDataBase.connection("recipes")
    .columns(["id", "tittle", "description", "user_id"])
    .insert({
        id: recipe.getId(),
        tittle: recipe.getTittle(),
        description: recipe.getDescription(),
        user_id: recipe.getUserId(),
    })
    .debug() // 控制台会打印实际执行的SQL和传入参数

额外提示：你建表语句中的tittle属于拼写错误（标准拼写为title），如果项目还在初期阶段建议尽早修正字段名，避免后续业务迭代出现字段名不统一的问题。

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