怎么通过HTML的crypto.subtle.generateKey生成对称或非对称密钥对-html教程-PHP中文网

crypto.subtle.generatekey生成aes等对称密钥时，首参须为字符串（如"aes-gcm"），且必须显式指定extractable和usages；usages需匹配操作（如["encrypt","decrypt"]），密钥长度须与算法一致（如aes-256对应length: 256），extractable: true才可导出密钥。

怎么通过html的crypto.subtle.generatekey生成对称或非对称密钥对

crypto.subtle.generateKey 生成对称密钥（如 AES）

生成对称密钥时，generateKey 的第一个参数必须是字符串或对象（如 "AES-GCM"），且 extractable 和 usages 必须显式指定——漏掉任一字段会直接抛错 TypeError: Cannot create a key with no usages。

常见错误是把 usages 写成 ["encrypt", "decrypt"] 却忘了密钥长度匹配算法要求：AES-128 要 length: 128，AES-256 则必须 length: 256，传 256 却用 "AES-128-GCM" 会失败。

extractable 设为 true 才能用 subtle.exportKey() 拿到原始字节；设 false（默认）则密钥只能在 SubtleCrypto 内部使用
usages 必须严格匹配后续操作：比如只写 ["encrypt"]，之后调 decrypt() 就报 OperationError
AES 密钥不支持 namedCurve 或 modulusLength，这些是给非对称算法用的，混用会静默失败或抛 DataError

const aesKey = await crypto.subtle.generateKey("AES-GCM", true, ["encrypt", "decrypt"]);
// ✅ 正确：算法名字符串 + extractable + 完整 usages

crypto.subtle.generateKey 生成非对称密钥对（如 RSA、ECDSA）

RSA 和 ECDSA 的调用结构完全不同：它们必须传入一个对象参数，含 name、modulusLength（RSA）或 namedCurve（ECC），且 usages 要分别指定给 publicKey 和 privateKey——很多人只写一个 usages 数组，结果 publicKey 没法 verify，privateKey 不能 sign。

RSA 最小 modulusLength 是 2048，设 1024 会抛 OperationError；ECC 的 namedCurve 只接受标准值如 "P-256"、"P-384"，写 "secp256r1" 或大小写错误（如 "p-256"）全都不行。

RSA 密钥对中，publicKey.usages 通常为 ["verify"]，privateKey.usages 为 ["sign"]；加密场景则反过来用 ["encrypt"]/["decrypt"]
ECC 不支持 modulusLength，传了会忽略或报错；RSA 不支持 namedCurve，写了就失效
extractable 只控制 privateKey 是否可导出；publicKey 总是可导出的（只要 extractable: true）

const rsaKeys = await crypto.subtle.generateKey(
  { name: "RSA-OAEP", modulusLength: 2048, publicExponent: new Uint8Array([1, 0, 1]), hash: "SHA-256" },
  true,
  { publicKey: ["encrypt"], privateKey: ["decrypt"] }
);

为什么 generateKey 返回的是 Promise 或 Promise

返回类型取决于算法：对称算法（AES、HMAC）返回 Promise<cryptokey></cryptokey>，因为只生成单个密钥；非对称算法（RSA、ECDSA、Ed25519）返回 Promise<cryptokeypair></cryptokeypair>，包含 publicKey 和 privateKey 两个属性。混淆这两者会导致解构错误，比如对 AES 结果写 const { publicKey } = await generateKey(...)，结果 publicKey 是 undefined。