Sequelize.js如何实现保存时自动生成按年递增补零的seqid字段值

实现结论 #

该场景需要Sequelize钩子（Hook）结合原生SQL查询能力（可通过sequelize.literal复用原有SQL逻辑），单独使用sequelize.literal无法稳定满足需求，也没法完全复刻原有业务规则。

为什么不推荐单独用sequelize.literal做字段默认值 #

• 执行时机不匹配：如果把原SQL直接作为seqid字段的defaultValue，本质上是把计算逻辑拼入INSERT语句的VALUES子句中，Sequelize对带跨表查询逻辑的默认值兼容性差，跨数据库部署时很容易出现语法报错。
• 并发场景易产生重复值：多个并发插入请求会同时执行MAX()查询，拿到完全相同的当年最大序号，最终生成重复seqid，且应用层没有插入逻辑的拦截节点，无法做串行化控制。
• 优先级不可控：如果业务层手动传入自定义seqid，默认值的覆盖逻辑容易出现偏差，不符合自定义值优先的常规预期。

具体实现方式 #

采用beforeCreate钩子，在数据正式插入数据库前，复用原SQL的计算逻辑生成seqid值，赋值给待插入实例，完全匹配原有规则：

1. 首先在Invoices模型定义中，将seqid设为字符串类型，无需设置硬默认值
2. 注册模型的beforeCreate钩子，逻辑如下：

const { DataTypes } = require('sequelize')

// 定义Invoices模型
Invoices.init({
  // ...其他业务字段定义
  seqid: {
    type: DataTypes.STRING,
    allowNull: false
  }
}, {
  sequelize,
  hooks: {
    beforeCreate: async (invoiceInstance, options) => {
      // 直接复用原有已验证的SQL计算逻辑，避免JS层重写出现逻辑偏差
      const nextSeqSql = `
        SELECT CONCAT(
          YEAR(CURDATE()),
          '-',
          LPAD(
            IFNULL(MAX(CONVERT(SUBSTR(seqid, 6), UNSIGNED INTEGER) + 1), 1),
            4,
            '0'
          )
        ) AS next_seqid
        FROM invoices
        WHERE seqid LIKE CONCAT(YEAR(CURDATE()), '-%')
      `
      // 执行查询，绑定当前事务上下文，避免脏读
      const result = await Invoices.sequelize.query(nextSeqSql, {
        plain: true,
        transaction: options.transaction
      })
      // 仅当实例未手动传入seqid时自动生成，保留自定义值的优先级
      if (!invoiceInstance.seqid) {
        invoiceInstance.seqid = result.next_seqid
      }
    }
  }
})

实现优势 #

• 逻辑完全对齐：没有在JS层重新实现字符串截取、数字转换、补零规则，和原有SQL的执行结果100%一致，不会出现索引偏移、转码错误之类的偏差
• 逻辑可控：可以灵活判断是否需要自动生成seqid，支持业务层手动传入自定义值的场景
• 事务兼容性好：查询时绑定当前操作的事务上下文，避免不同事务隔离级别下的脏读问题

注意事项 #

• 原有SQL本身存在并发漏洞：如果高并发下多个请求同时执行MAX查询，会生成重复seqid。要解决这个问题，需要在生成seqid时配合串行事务、行锁，或单独维护独立的序号计数器表，这是原逻辑的固有问题，和Sequelize实现方式无关。
• 批量插入场景需要调整逻辑：默认的beforeCreate钩子会对每一条待插入的记录单独执行一次查询，批量插入时循环查库效率极低，批量场景下需要单独实现批量生成seqid的逻辑，避免反复查库。

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