fix: 业务编号追加随机位并加唯一约束

This commit is contained in:
2026-10-09 12:20:36 +08:00
parent 67c8711eee
commit 3cc3be1c8b
3 changed files with 56 additions and 17 deletions
@@ -2,36 +2,51 @@ package com.guo.learningprogresstracker.utils;
import lombok.RequiredArgsConstructor;
import java.security.SecureRandom;
import java.text.SimpleDateFormat;
import java.util.Date;
/**
* 用于生成编码的工具
* <p>编码格式:{@code PREFIX-yyyyMMdd-<6 位毫秒片段><6 位随机数>}。</p>
* <p>此前只用「毫秒时间戳对 1_000_000 取模」的 6 位片段,同一毫秒内会生成完全相同的编码,
* 且该片段每 16.7 分钟就会重复一轮;现在追加 6 位随机数把撞号概率降到 1e-6 量级,
* 最终防线是数据库唯一索引(见迁移 {@code V20261009_3})。</p>
*/
@RequiredArgsConstructor
public class GenerateNumTool {
private static int getNextSequence() {
long timestamp = System.currentTimeMillis();
return (int) (timestamp % 1_000_000);
/** 毫秒片段取值范围:保持既有编码的可读形态 */
private static final int MILLIS_SEQUENCE_BOUND = 1_000_000;
/** 随机位取值范围:6 位 */
private static final int RANDOM_BOUND = 1_000_000;
private static final SecureRandom RANDOM = new SecureRandom();
private static long getNextSequence() {
return System.currentTimeMillis() % MILLIS_SEQUENCE_BOUND;
}
/**
* 生成以prefix开头separator分割的编码
* 例如:PREFIX—20240711-423468
* @param prefix
* @param separator
* @return
* 生成以 prefix 开头、separator 分割的编码
* 例如:PREFIX-20240711-423468123905
*/
public static String generateNum(String prefix, String separator) {
String currentDate = new SimpleDateFormat("yyyyMMdd").format(new Date());
int sequence = getNextSequence();
return prefix + separator + currentDate + separator + sequence;
return prefix + separator + currentDate + separator + randomSuffix();
}
public static String generateNum(String prefix) {
String separator = "-";
String currentDate = new SimpleDateFormat("yyyyMMdd").format(new Date());
int sequence = getNextSequence();
return prefix + separator + currentDate + separator + sequence;
return generateNum(prefix, "-");
}
/**
* 编码后缀:6 位毫秒片段 + 6 位随机数,固定 12 位,便于阅读与排序。
*/
private static String randomSuffix() {
long sequence = getNextSequence();
int random = RANDOM.nextInt(RANDOM_BOUND);
return String.format("%06d%06d", sequence, random);
}
}