深入解析Go-Jet项目中Sqlite GENERATED列的插入问题

在Go-Jet项目的最新版本2.11.1中，针对Sqlite数据库的GENERATED列支持带来了一个值得开发者注意的行为变化。本文将详细分析这个问题的本质、产生原因以及解决方案。

问题背景

当使用Go-Jet与Sqlite数据库交互时，如果表结构中包含GENERATED列（计算列），在进行数据插入操作时可能会遇到"列数不匹配"的错误。例如，一个包含3个常规列和8个GENERATED列的表，在插入数据时会报告"表有3列但提供了11个值"的错误。

技术原理

GENERATED列是Sqlite 3.31.0版本引入的特性，这些列的值由表达式自动计算得出，而非直接存储。在Go-Jet 2.11.1版本中，模型生成器会为GENERATED列创建对应的字段，但在实际插入操作时，Sqlite引擎并不接受为这些计算列提供显式值（即使是NULL值）。

问题复现

考虑以下表结构定义：

CREATE TABLE test (
    created_at date DEFAULT CURRENT_TIMESTAMP,
    updated_at date,
    jvalues TEXT NOT NULL,
    j1 TEXT GENERATED ALWAYS as (JSON_EXTRACT(jvalues, "$.J1")),
    -- 其他7个类似的GENERATED列...
);

当使用Go-Jet的模型插入方式时：

r := model.Test{Jvalues: jvalues}
insert := Test.INSERT().MODEL(r)

会导致上述列数不匹配的错误。

解决方案

方案一：显式指定列

最直接的解决方案是在插入时明确指定要插入的列：

insert := Test.INSERT(Test.Jvalues).VALUES(jvalues)

方案二：结合模型和列指定

为了保持类型检查的优势，可以结合模型和列指定：

r := model.Test{Jvalues: jvalues}
insert := Test.INSERT(Test.Jvalues).MODEL(r)

方案三：使用MutableColumns

Go-Jet提供了更优雅的解决方案，使用MutableColumns方法自动排除不可变列：

insert := Test.INSERT(Test.MutableColumns...).MODEL(r)

最佳实践建议

1. 对于包含GENERATED列的表，始终明确指定插入列
2. 考虑在项目中使用MutableColumns作为默认实践
3. 在模型定义文档中明确标注GENERATED列
4. 编写单元测试验证插入行为是否符合预期

总结

Go-Jet对Sqlite GENERATED列的支持是一个进步，但也带来了新的使用注意事项。理解数据库引擎对计算列的处理方式，并采用适当的插入策略，可以确保应用的稳定性和可维护性。随着Go-Jet项目的持续发展，这类边界情况的处理将会更加完善。

对于开发者而言，掌握这些细节不仅能解决当前问题，也能加深对ORM框架与数据库交互机制的理解，为处理其他类似场景积累经验。