static关键字不能安全存储盐值和iv，因其共享性违背随机唯一原则；应仅用static封装生成逻辑、编码工具及配置，默认参数可静态定义，但salt与iv必须每次动态生成并随密文持久化。
static 关键字本身不能安全地统一管理盐值（salt）和初始向量（IV）——这是个常见误解，需要先厘清核心原则：
盐值与 IV 必须是随机、唯一、不可复用的，而 static 字段在类加载时初始化一次、全程共享，违背了这一前提。若强行用 static 存储固定 salt 或 IV，会导致：
- 所有加密操作使用相同 salt → 密钥派生结果可预测，PBKDF2 失效
- 所有加密使用相同 IV → CBC/GCM 模式下语义安全性崩溃，明文模式暴露风险剧增
- 多用户/多请求场景下密文可被关联分析，极易被重放或篡改
真正安全的做法，是用 static 管理生成逻辑与配置，而非存储值本身。下面分三部分说明：
盐值与 IV 的生成必须动态且独立
每次加密前都应生成全新、密码学安全的随机值：
- Salt：16 字节（128 位），用于 PBKDF2 密钥派生
-
IV：12 字节（GCM）或 16 字节（CBC），用于对称加密模式
二者均需随密文一同持久化（如 Base64 编码后拼接），解密时再分离还原。
// ✅ 正确：每次加密生成新 salt 和 iv const generateSalt = () => crypto.getRandomValues(new Uint8Array(16)); const generateIV = () => crypto.getRandomValues(new Uint8Array(12)); // GCM 推荐长度 // ❌ 错误：static 常量 salt/iv（绝对禁止） // static readonly SALT = new Uint8Array([/*...*/]); // 危险！
利用 static 封装安全生成器与编码工具
static 适合封装无状态、幂等、纯函数式的工具方法，例如：
- Base64 编解码工具（避免手动
btoa/atob编码污染） - IV/salt 格式校验逻辑（如长度检查、Base64 合法性）
- 加密参数默认配置（如
iterations=100_000,hash='SHA-256'）
class CryptoUtils {
static readonly DEFAULT_ITERATIONS = 100_000;
static readonly KEY_LENGTH = 256;
static toBase64(buf: Uint8Array): string {
return btoa(String.fromCharCode(...buf));
}
static fromBase64(str: string): Uint8Array {
const bin = atob(str);
return Uint8Array.from(bin, c => c.charCodeAt(0));
}
static validateSalt(salt: string): boolean {
const bytes = this.fromBase64(salt);
return bytes.length === 16;
}
}
静态服务类应只负责协调，不持有敏感值
可定义 static 方法作为入口，但内部调用动态生成逻辑：
class EncryptionService {
// ✅ static 方法作为统一入口，但内部不缓存 salt/iv
static async encrypt(plaintext: string, password: string): Promise<string> {
const salt = crypto.getRandomValues(new Uint8Array(16));
const iv = crypto.getRandomValues(new Uint8Array(12));
const key = await this.deriveKey(password, salt);
const encrypted = await crypto.subtle.encrypt(
{ name: 'AES-GCM', iv },
key,
new TextEncoder().encode(plaintext)
);
// 拼接 salt|iv|ciphertext（Base64 分隔）
return [
CryptoUtils.toBase64(salt),
CryptoUtils.toBase64(iv),
CryptoUtils.toBase64(new Uint8Array(encrypted))
].join('.');
}
private static async deriveKey(pwd: string, salt: Uint8Array) {
const enc = new TextEncoder();
const pwKey = await crypto.subtle.importKey(
'raw', enc.encode(pwd), 'PBKDF2', false, ['deriveKey']
);
return crypto.subtle.deriveKey(
{ name: 'PBKDF2', salt, iterations: CryptoUtils.DEFAULT_ITERATIONS, hash: 'SHA-256' },
pwKey,
{ name: 'AES-GCM', length: 256 },
true,
['encrypt', 'decrypt']
);
}
}</string>
不复杂但容易忽略：static 是组织代码的语法糖，不是安全机制。真正的安全性来自每次调用时的真随机、唯一性保障和参数显式传递。
