本文详解 JsStore IndexedDB 中 date_time 列的正确使用方式，重点解决因主键复合键（primaryKey keyPath）配置冲突与日期格式不兼容导致的 DataError 插入失败问题，并提供可直接运行的修复方案。
本文详解 jsstore indexeddb 中 `date_time` 列的正确使用方式，重点解决因主键复合键（primarykey keypath）配置冲突与日期格式不兼容导致的 `dataerror` 插入失败问题，并提供可直接运行的修复方案。
JsStore 对 date_time 类型字段有明确的内部校验逻辑：它要求传入的值必须是 JavaScript Date 实例对象（即 instanceof Date === true），而非字符串（如 ISO 格式）、时间戳数字或任何其他类型。这是许多开发者踩坑的核心原因——即使 toISOString() 语义上表示精确时间，JsStore 也不会自动解析字符串为 Date 对象。
更关键的是，复合主键（keyPath: ['K_A', 'DT_VAL']）与 date_time 类型字段共存时存在隐式限制。JsStore 的索引机制在处理复合主键时，会对每个键路径成员进行严格类型匹配和序列化操作；而 date_time 字段若被纳入 primaryKey.keyPath，其底层序列化行为可能与预期不符，尤其在旧版本中易触发 DataError。正如实践所验证：移除 DT_VAL 在 keyPath 中的参与，仅保留其作为普通 date_time 列，并将主键逻辑交由 primaryKey: true 单字段声明（或显式组合逻辑），即可绕过该限制。
以下是推荐的、经验证的正确配置与插入代码：
// ✅ 正确的表结构定义
const table = {
name: "TEST",
columns: {
K_A: {
dataType: "string",
primaryKey: true // 单字段主键（字符串）
},
DT_VAL: {
dataType: "date_time",
primaryKey: true // 允许作为复合主键成员 —— 但需确保 JsStore v4+ 且避免 keyPath 冲突
},
DT_SENT: {
dataType: "date_time"
}
}
};
// ⚠️ 注意：JsStore v4.0+ 支持多字段主键，但强烈建议避免在 keyPath 中混用 date_time
// 更稳妥写法（推荐）：仅用字符串字段作主键，date_time 作为普通索引列
/*
columns: {
K_A: { dataType: "string", primaryKey: true },
DT_VAL: { dataType: "date_time" },
DT_SENT: { dataType: "date_time" }
}
*/
// ✅ 正确的数据插入方式：必须传入 Date 实例
const record = {
K_A: "A",
DT_VAL: new Date(), // ✔️ Date 对象（非字符串！）
DT_SENT: new Date() // ✔️ 同上
};
// 执行插入（禁用验证以排除 schema 干扰，生产环境建议开启）
await db.connection.insert({
into: "TEST",
values: [record], // 注意：values 是数组
upsert: true,
validation: false
});重要注意事项：
- ❌ 禁用 keyPath 配置在 date_time 字段上（如 sent: { keyPath: ["DT_SENT"] }），JsStore 不支持对 date_time 类型创建独立索引键路径；如需查询优化，请改用 index: true 属性（例如 { dataType: "date_time", index: true }）。
- ✅ 主键复合声明应通过 primaryKey: true 显式标注多个列，而非手动配置 keyPath —— 这是 JsStore v4 的标准语法。
- ? 若必须使用 DT_VAL 参与主键，确保 JsStore 版本 ≥ 4.1.0，并在初始化数据库前调用 db.validate() 检查 schema 兼容性。
- ? 调试技巧：插入前校验类型 console.assert(record.DT_VAL instanceof Date, 'DT_VAL must be a Date object');。
总结而言，成功插入 date_time 数据的关键在于两点：数据层面坚持使用 new Date() 实例，架构层面规避 keyPath 与 date_time 的不当组合。遵循此原则，即可稳定、高效地在 JsStore 中管理时间敏感型业务数据。
