如何在ASP.NET Core中生成支付交易唯一标识vendorTxCode

针对支付网关场景下要求每笔交易vendorTxCode全局唯一的需求，以下是3种不同适配场景的实现方案：

方案1：GUID变体（开箱即用，零额外依赖） #

是中小型项目的首选方案，无需额外开发、无状态，分布式场景下也不会出现重复：

• 常规32位无特殊字符版本，适配绝大多数支付通道的参数规范：

// 生成32位十六进制字符串，无连字符、无特殊字符
string vendorTxCode = Guid.NewGuid().ToString("N");

• 短长度压缩版本，适合对参数长度有严格要求的场景，最终长度22位：

string vendorTxCode = Convert.ToBase64String(Guid.NewGuid().ToByteArray())
    .Replace("/", "_")
    .Replace("+", "-")
    .TrimEnd('=');

优点：性能极高、不会重复、无需依赖任何存储/中间件
缺点：无业务含义，无法从编码反推交易相关信息

方案2：时间戳+安全随机数组合（带业务可读性） #

适合需要从vendorTxCode直接识别交易时间的场景，生成规则可自定义：

// 格式：UTC时间（到毫秒） + 3位安全随机数 + 自定义业务标识（可选）
var randomBuffer = new byte[2];
RandomNumberGenerator.Fill(randomBuffer);
int randomSuffix = BitConverter.ToUInt16(randomBuffer) % 1000;
string vendorTxCode = $"{DateTime.UtcNow:yyyyMMddHHmmssfff}{randomSuffix:D3}";

注意：高并发场景不要用默认Random类，非线程安全的Random实例在高并发下会生成重复随机数，必须用RandomNumberGenerator生成密码学安全的随机值
优点：编码自带交易时间属性，方便后续问题排查，长度可自定义
缺点：每秒交易超过1000笔时需要额外增加机器/实例标识避免重复，分布式部署时要注意服务器时钟同步

方案3：雪花算法（Snowflake）分布式ID（适合超大规模高并发场景） #

针对多实例部署、每秒交易过万的大规模支付系统，用雪花算法生成有序长整型唯一值：

1. 先注册雪花算法服务到DI容器：

// Program.cs中注册，自行实现SnowflakeIdGenerator，注意不同实例配置唯一的WorkerId
builder.Services.AddSingleton<ISnowflakeIdGenerator>(sp => 
    new SnowflakeIdGenerator(workerId: 1, datacenterId: 1));

2. 业务中调用生成：

public class TransactionController : ControllerBase
{
    private readonly ISnowflakeIdGenerator _idGenerator;
    public TransactionController(ISnowflakeIdGenerator idGenerator)
    {
        _idGenerator = idGenerator;
    }

    [HttpPost("create")]
    public IActionResult CreateTransaction()
    {
        string vendorTxCode = _idGenerator.NextId().ToString();
        // 后续业务逻辑
    }
}

优点：全局唯一、有序、性能极高，分布式多实例场景下无重复风险
缺点：需要提前为每个实例分配唯一的WorkerId，避免节点ID冲突

选型参考 #

• 并发低于1万TPS的项目：直接选方案1的无连字符GUID，零开发成本无坑
• 需要业务可读性：选方案2，并发高时在后缀加2位实例标识即可
• 大规模分布式支付系统：选方案3的雪花算法或成熟的分布式发号器

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