JavaScript 中实现与服务端一致的 3DES (DES-ede) 加密方案

3DES 在 Web 前端的应用背景

3DES（Triple Data Encryption Algorithm）是通过对每个数据块应用三次 DES 加密算法的块密码通称。由于原版 DES 密钥长度较短，容易受到暴力破解攻击，3DES 通过增加密钥长度来提升安全性，其核心过程为 en(k3, de(k2, en(k1, P)))。在前端项目中，当需要与遗留系统或特定后端服务进行数据交换时，常需在前端实现相同的加解密逻辑。

虽然市面上存在多种 JS DES 库（如早期的 tero.co.uk 版本），但直接使用时往往会遇到“假性不兼容”，并非算法错误，而是参数配置差异。

关键坑点一：密钥长度与结构适配

常见的开源 JS DES 库默认根据密钥长度判断加密轮数：
var iterations = key.length > 8 ? 3 : 1;
该逻辑假设超过 8 字节即为 3DES。然而，标准的 DES-ede 密钥通常有 64 位、128 位或 192 位三种情况。更关键的是，许多库未正确处理 128 位密钥场景下的 k1=k3 优化结构。

正确的 3DES 密钥拼接应遵循以下规则：
1. **192 位**：直接传入 k1 + k2 + k3。
2. **128 位**：虽然实际仅用两个密钥段，但在逻辑上应视为 k1 + k2 + k1 的模式。如果前端直接将 128 位密钥填入 192 位长度的变量，或者库内部简单截取，会导致计算偏差。

在实际操作中，若后端使用的是 128 位密钥，前端构造密钥时应确保传递给加密函数的字符串包含完整的 k1k2k1 序列，或者直接利用库支持的 k1,k2,k3 分离参数（若可用）。对于多数单字符串输入的库，必须手动将 128 位密钥扩展为 key_128bit + key_128bit.substring(0, 8) 以符合内部逻辑。

关键坑点二：填充模式（Padding Mode）的对齐

块加密要求数据长度为块大小（DES 为 8 字节）的整数倍。不同语言的默认填充策略不同：

• Java / C#：默认通常使用 PKCS5/PKCS7 填充。
• 部分旧版 JS 库：可能默认使用空格填充（' '）或零值填充（'\0'）。

若填充不一致，前端加密后的密文在后端将无法正确还原，且报错信息往往晦涩。因此，必须强制指定使用 PKCS7 标准。

// 源码中的 padding 逻辑片段解析
if (padding == 2) message += " "; // 空格填充（易出错）
else if (padding == 1) {
    // PKCS7 填充：用数值表示缺失的字节数
    temp = 8-(len%8);
    message += String.fromCharCode(temp,temp,temp,temp,temp,temp,temp,temp);
}

在调用加密函数时，务必确认 `padding` 参数传值为 1（对应上述源码中的 PKCS7 分支）。

完整调用示例

以下代码演示了如何构造符合服务端要求的 128/192 位混合密钥，并启用正确的填充模式。假设使用类库中的 `des` 函数：

var key = "b964b7c58e99b59"+"b964b7c5"; // 此处仅为示意，实际需根据后端真实192位或128位密钥调整
var message = "This is a test message";
// 参数说明:
des(key, message, iterations=1, padding_mode=1, ...);
// 注意：具体参数索引需参考所用库的文档，上述示例基于通用逻辑修正

经上述修正后，前端输出的 Hex 密文应与服务端 DES-ede 生成的密文完全一致，可顺利打通联调。