技术积累 · 加密

AES-GCM 两端配对,差一个参数都不行

签发侧能加密、验证侧解不开——报错只说 Decryption failed。排查到最后,问题不在算法,而在"两端派生参数没有共用同一份定义"。

三个必须逐字节一致的点

派生参数:主密钥派生用 PBKDF2,盐、迭代次数、哈希算法、输出长度,任何一项不一致,得到的密钥就完全不同——而且这种"不同"没有任何报错线索,只是解密结果是一堆乱码或直接认证失败。

密文布局:nonce、密文、认证标签三段的拼接顺序和长度(12 字节 nonce、16 字节 tag)必须约定一致。顺序错了,连 nonce 都读不对。

编码格式:密文以 Base64 传输时,注意 Base64url 与标准 Base64 的字符差异,以及 UTF-8 BOM 这类看不见的前缀字符。

让两端永远一致的三个做法

派生逻辑只写一份:把"从主密钥派生子密钥"做成静态方法,两端共用同一份代码而不是各自实现。自验证兜底:签发端在签发后立刻用与验证端相同的参数做一次"加密→解密"往返,失败立即暴露。错误日志带上下文:解密失败时打印密钥长度(而非密钥内容),一眼看出是参数错位还是密钥不同。

排查时另一个有用的信号:解密失败的报错里如果打印了密钥相关的奇怪字符,往往说明配置本身读错了值——比算法不一致更早发生。

一句话总结:加解密两端不怕算法不同(协商一致即可),怕的是"以为一致"。共用一份派生定义,是唯一可靠的做法。
← 放弃 EF 迁移 最新一篇