Strapi 4.15.5自动生成订单编号（如ord103）实现方案咨询

1. 配置订单模型字段 #

首先在你的订单内容类型（假设为Order）的schema中添加orderno字段，设置为唯一、必填且不可手动编辑：

编辑src/api/order/content-types/order/schema.json：

{
  "attributes": {
    // 其他业务字段...
    "orderno": {
      "type": "string",
      "unique": true,
      "required": true,
      "configurable": false, // 禁止在Strapi后台手动编辑该字段
      "private": false // 根据业务需求决定是否返回给前端
    }
  }
}

2. 编写生命周期钩子实现自动生成逻辑 #

利用Strapi的beforeCreate生命周期钩子，在订单创建前自动生成编号：

创建/编辑src/api/order/content-types/order/lifecycles.js：

module.exports = {
  async beforeCreate(event) {
    const { data } = event.params;
    
    // 查询最新的订单，获取当前最大的订单编号
    const lastOrder = await strapi.db.query('api::order.order').findOne({
      orderBy: { orderno: 'desc' },
      select: ['orderno'],
    });

    let nextSeqNumber = 101; // 默认起始编号
    if (lastOrder) {
      // 提取编号中的数字部分并自增
      const numPart = lastOrder.orderno.replace(/^ord/, '');
      nextSeqNumber = parseInt(numPart, 10) + 1;
    }

    // 拼接成目标格式的订单编号
    data.orderno = `ord${nextSeqNumber}`;
  },
};

3. 处理并发冲突（可选） #

如果系统存在高并发创建订单的场景，可能出现编号重复问题（查询与创建操作存在时间窗口）。可以添加重试逻辑处理数据库唯一约束冲突：

更新lifecycles.js：

module.exports = {
  async beforeCreate(event) {
    const { data } = event.params;
    let retryCount = 3; // 设置重试次数

    while (retryCount > 0) {
      try {
        const lastOrder = await strapi.db.query('api::order.order').findOne({
          orderBy: { orderno: 'desc' },
          select: ['orderno'],
        });

        let nextSeqNumber = 101;
        if (lastOrder) {
          const numPart = lastOrder.orderno.replace(/^ord/, '');
          nextSeqNumber = parseInt(numPart, 10) + 1;
        }

        data.orderno = `ord${nextSeqNumber}`;
        break; // 生成成功，退出循环
      } catch (err) {
        // 捕获唯一约束冲突错误（示例为PostgreSQL错误码，不同数据库需调整）
        if (err.code === '23505' || err.message.includes('unique constraint')) {
          retryCount--;
          if (retryCount === 0) throw err; // 重试耗尽，抛出原错误
          await new Promise(resolve => setTimeout(resolve, 100)); // 短暂等待后重试
        } else {
          throw err; // 其他错误直接抛出
        }
      }
    }
  },
};

4. 测试验证 #

启动Strapi服务后，通过后台或API创建订单，orderno字段会自动生成ord101、ord102、ord103格式的唯一编号。

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