第4章 SM2密钥对生成测试：接口调用、参数校验与异常场景

SM2密钥对生成，是所有国密应用的第一步。

这一步要是出了问题，后面的加解密、签名验签全得崩。我自己在项目中就见过不少团队，密钥生成的代码写着写着就跑偏了，查半天才发现是密钥类型不对或者随机数种子有问题。

这章咱们就掰开揉碎，把SM2密钥对生成的接口调用、参数校验和异常场景，全都捋一遍。

4.1 密钥对生成原理与接口规范

先说原理。SM2用的是椭圆曲线密码体制，曲线参数是国标里写死的。生成密钥对的过程，说白了就是：

• 私钥：随机生成一个大整数，范围在 [1, n-1] 之间，n是曲线的阶
• 公钥：用私钥乘以椭圆曲线上的基点G，得到一个点坐标 (x, y)

嗯，这个问题看似简单，但坑在哪？一个是随机数的质量，另一个是密钥格式的规范化。

不同厂商的接口风格差异很大。我个人习惯把接口调用按以下维度分层：

接口类型	典型格式	常见厂商
Java Bouncy Castle方式	BC原生库 + Provider	OpenJDK + BC 扩展
C/C++ 动态库方式	DLL/.so + 导出函数	吉大正元、信安世纪
密码机硬件接口	PKCS#11 / CUAC接口	江南天安、三未信安
HTTP RESTful方式	JSON/XML + 签名	云密码机、密码服务平台

你想想看，同一个应用，如果要从Bouncy Castle迁移到密码机，密钥生成的参数名称、格式、异常码全都不一样。这就是我们为什么要做兼容性测试。

4.2 密钥对生成接口调用实战

咱们拿Java Bouncy Castle举个例子。虽然BC不是国密原生库，但它支持SM2曲线参数，很多项目都在用。

import org.bouncycastle.jce.provider.BouncyCastleProvider;
import org.bouncycastle.jce.spec.ECParameterSpec;
import org.bouncycastle.math.ec.ECCurve;
import java.security.KeyPairGenerator;
import java.security.KeyPair;
import java.security.Security;

Security.addProvider(new BouncyCastleProvider());

// 获取SM2曲线参数
ECCurve curve = new ECCurve.Fp(
    new BigInteger("FFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000FFFFFFFFFFFFFFFF", 16),
    new BigInteger("FFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000FFFFFFFFFFFFFFFC", 16),
    new BigInteger("28E9FA9E9D9F5E344D5A9E4BCF6509A7F39789F515AB8F92DDBCBD414D940E93", 16)
);
ECParameterSpec ecSpec = new ECParameterSpec(
    curve,
    curve.decodePoint(Hex.decode("04" + "32C4AE2C1F1981195F9904466A39C9948FE30BBFF2660BE1715A4589334C74C7" + "BC3736A2F4F6779C59BDCEE36B692153D0A9877CC62A474002DF32E52139F0A0")),
    new BigInteger("FFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFF7203DF6B21C6052B53BBF40939D54123", 16),
    1
);

KeyPairGenerator kpg = KeyPairGenerator.getInstance("EC", "BC");
kpg.initialize(ecSpec, new SecureRandom());
KeyPair kp = kpg.generateKeyPair();

这里有个要命的细节：SecureRandom必须用加密安全的随机数发生器。我见过有人直接传入new Random()，结果密钥强度太低，直接被安全检测卡住。

4.3 参数校验清单与测试点

密钥对生成接口的参数校验，是兼容性测试的重点。我通常会列一个清单，逐项验证：

参数项目	校验内容	预期结果
曲线标识符	是否支持SM2（OID: 1.2.156.10197.1.301）	生成成功或明确不支持错误
密钥长度	SM2固定256位，传入非法长度	抛出参数异常
随机数种子	传入空种子、固定种子、劣质种子	空种子取系统默认，固定种子密钥相同
密钥对缓存	重复调用是否生成不同密钥	每次不同（非固定）
导出格式	PEM/DER/Base64原始字节	各格式可互相转换

为什么特别强调随机数种子？因为有些密码机硬件，种子池一旦耗尽，密钥对生成就会卡死或返回假随机数。我在测试某款密码机时，连续调用1万次密钥生成，结果第3000次开始返回的密钥居然有规律性变化——后来发现是随机数发生器的熵池没有及时补充。

4.4 异常场景测试：不能只测正常流程

兼容性测试，最值钱的部分其实是异常场景。正常流程每个厂商都差不多，但在异常场景下，差距就出来了。我总结了几类必测的异常场景：

1. 空参数测试：传入null密钥类型/null曲线参数，接口能否正确报错
2. 非对称密钥误传：把RSA密钥生成参数塞进SM2接口，返回什么
3. 椭圆曲线参数被篡改：修改a/b系数或基点坐标，是否检测出来
4. 并发调用：多线程同时生成密钥对，会不会出现死锁或重复
5. 资源耗尽测试：长时间连续调用，内存/句柄是否泄漏
6. 私钥长度异常：返回私钥长度不对（比如多了空字节或被截断）

嗯，这里我重点说一下并发生成。有些密码库的密钥对生成器不是线程安全的，不加锁直接在Web服务里用，请求一多就崩。我建议测试时用100个并发线程，每个线程生成500对密钥，观察是否出现非预期异常。

4.5 知识体系与测试流程总览

为了方便理解，我把SM2密钥对生成测试的整体逻辑画成一张图。你一看就明白：

你看这张图，从准备工作到最终报告，中间功能验证、参数校验、异常场景三条线并行测试。其中任意一条线出问题，密钥对生成的兼容性评级就得打折扣。

我个人建议，把这套测试流程固化到CI/CD里。每次构建自动跑一遍，发现问题立即回退。别等到上线前才手工测，那时候已经晚了。

4.6 常见失败模式与修复

把我在项目中踩过的坑列出来，希望能帮你少走弯路：

失败模式	现象	根因	修复方案
密钥长度不一致	厂商A返回32字节，厂商B返回33字节（含04前缀）	公钥编码格式不统一	统一规范：私钥32字节，公钥取非压缩65字节
随机数种子耗尽	连续生成后出现重复密钥	硬件熵池性能不足	加入随机数种子补充机制
并发死锁	多线程调用时程序挂起	底层资源未加锁	使用ThreadLocal或连接池
空指针崩溃	传入null参数直接抛未处理异常	接口未做防御性编程	参数校验前置，统一返回错误码

说白了，密钥对生成这件事，看起来简单，实际上藏着很多细节。每次兼容性测试，我都要把上面这张表格里的每一条都验证一遍，才敢放心上线。

嗯，这一章的核心内容就到这儿。你按照我说的流程走一遍，SM2密钥对生成的兼容性测试基本就能稳住了。