企业官网建设流程全解析

1. 项目概述：跨平台数据安全通信的基石

在前后端分离、微服务架构大行其道的今天，我们经常会遇到一个看似简单却暗藏玄机的问题：如何让运行在Windows服务器上的C#后端服务，与部署在Linux容器里的Node.js前端服务，安全地交换数据？尤其是在处理一些敏感信息，比如用户令牌、配置参数或临时会话数据时，直接明文传输无异于“裸奔”。这时，一个轻量级、标准化且双方都能理解的加密算法就成了刚需。DES（Data Encryption Standard）算法，尽管在绝对安全强度上已让位于AES，但其算法标准明确、实现广泛、计算资源消耗相对较低的特点，使其在大量遗留系统、对性能有特定要求的内部系统，以及作为教学和原理验证的场景中，依然保持着旺盛的生命力。

这个项目的核心目标，就是打通C#与Node.js之间的DES加密解密通道。这不仅仅是调用两个库、写几行代码那么简单。真正的挑战在于“对齐”：加密模式（ECB还是CBC？）、填充方式（PKCS7还是其他？）、密钥和初始向量（IV）的编码与处理、以及最终密文的输出格式（Hex字符串还是Base64？）。任何一个环节的微小差异，都会导致“明明密钥一样，为什么C#加密的Node.js解不开？”的经典困境。我经历过不少项目，因为跨语言加密解密不一致，导致联调阶段耗费大量时间在“猜谜”上。因此，本文将不仅提供可运行的代码，更会深入每个参数和配置背后的逻辑，手把手带你实现C#与Node.js在DES加密解密上的完美互操作，让你彻底告别跨语言加解密的烦恼。

2. DES算法核心原理与跨语言互操作性的关键

在动手写代码之前，我们必须先统一思想，理解那些会导致跨语言加密结果不一致的“魔鬼细节”。DES是一种对称分组加密算法，所谓对称，就是加密和解密使用同一把密钥。它的分组长度是64位（8字节），密钥长度也是64位，但实际有效密钥是56位，另有8位用于奇偶校验。

2.1 决定互操作性成败的三大配置

要让C#和Node.js的DES实现能互相理解，你必须确保以下三个核心配置完全一致，它们比密钥本身还重要：

1. 加密模式（Cipher Mode）：这是决定算法如何迭代加密每个数据块的核心规则。

   • ECB（电子密码本）：最简单的模式，每个64位的块独立加密。相同的明文块会产生相同的密文块。这在加密图像等数据时，可能会保留原始数据的模式，安全性较低，不推荐用于需要保密性的场景。但其优点是无须初始向量（IV），实现简单，在某些内部校验场景仍有使用。
   • CBC（密码分组链接）：最常用的模式之一。每个明文块在加密前，会先与前一个密文块进行异或操作。第一个块则需要一个初始向量（IV）来参与运算。这消除了ECB的模式问题，相同的明文块在不同位置会产生不同的密文块，安全性更高。这是默认或推荐的选择，但要求双方必须使用相同的IV。

2. 填充模式（Padding Mode）：DES处理的是64位（8字节）的块。当明文长度不是8字节的整数倍时，就需要填充到合适的长度。

   • PKCS7（PKCS#5）：这是最通用、最推荐的填充方式。假设需要填充N个字节，那么每个填充的字节值都是N。例如，如果差3字节，则填充0x03 0x03 0x03。在.NET和Node.js的crypto模块中，这通常是默认或最兼容的选项。
   • 其他：如ZeroPadding（补零）、ISO10126等，如果两端不统一，解密时就会得到乱码。

3. 密钥与初始向量（IV）的处理：

   • 密钥：DES要求8字节（64位）的密钥。如果你提供的字符串不是8字节（UTF-8编码下，一个中文通常是3字节），就需要进行转换或截断。通常做法是将字符串用UTF-8编码成字节数组，然后取前8个字节，或使用特定的密钥派生函数。
   • 初始向量（IV）：仅在CBC等模式下需要。IV的长度必须等于分组大小，即8字节。它不需要保密，但必须随机且每次加密最好不同（对于同一密钥），以增强安全性。在跨语言通信中，IV通常需要和密文一起传输给对方。

2.2 输出格式的统一

加密后的结果是字节数组。为了在网络传输或日志中方便表示，需要将其编码成字符串。

• 十六进制（Hex）字符串：每个字节转换为两个0-9A-F的字符。可读性好，但长度会增加一倍。
• Base64字符串：将3个字节编码为4个字符，更节省空间，是网络传输的常见格式。

关键点：双方必须约定好使用同一种输出格式。C#加密后输出Hex，Node.js解密时就必须按Hex解析，反之亦然。

理解了这些，我们就有了实现互操作的“地图”。接下来，我们分别进入C#和Node.js的世界，看看如何具体实现，并确保它们严丝合缝地对齐。

3. C#端DES加密解密实现详解

在C#中，我们使用System.Security.Cryptography命名空间下的DESCryptoServiceProvider或更现代的Aes类（对于DES，我们用前者）。我将提供一个健壮、可配置的工具类。

3.1 核心工具类封装

首先，创建一个DesHelper类，它同时支持ECB和CBC模式，并允许选择输出格式。

using System; using System.IO; using System.Security.Cryptography; using System.Text; public class DesHelper { /// <summary> /// DES加密 /// </summary> /// <param name="plainText">待加密的明文</param> /// <param name="key">密钥，必须为8个字符（UTF-8编码下8字节）</param> /// <param name="iv">初始向量，CBC模式时必须为8个字符，ECB模式时忽略</param> /// <param name="mode">加密模式，默认为CBC</param> /// <param name="outputFormat">输出格式，Hex或Base64</param> /// <returns>加密后的密文字符串</returns> public static string Encrypt(string plainText, string key, string iv = null, CipherMode mode = CipherMode.CBC, string outputFormat = "Hex") { if (string.IsNullOrEmpty(plainText)) throw new ArgumentNullException(nameof(plainText)); if (string.IsNullOrEmpty(key) || Encoding.UTF8.GetByteCount(key) != 8) throw new ArgumentException("DES密钥必须为8字节（UTF-8编码下8个字符）。", nameof(key)); if (mode == CipherMode.CBC && (string.IsNullOrEmpty(iv) || Encoding.UTF8.GetByteCount(iv) != 8)) throw new ArgumentException("CBC模式下的初始向量(IV)必须为8字节。", nameof(iv)); using (DES des = DES.Create()) { des.Key = Encoding.UTF8.GetBytes(key); des.Mode = mode; des.Padding = PaddingMode.PKCS7; if (mode == CipherMode.CBC) { des.IV = Encoding.UTF8.GetBytes(iv); } // ECB模式不需要IV，即使设置了也会被忽略 using (var memoryStream = new MemoryStream()) using (var cryptoStream = new CryptoStream(memoryStream, des.CreateEncryptor(), CryptoStreamMode.Write)) { byte[] plainBytes = Encoding.UTF8.GetBytes(plainText); cryptoStream.Write(plainBytes, 0, plainBytes.Length); cryptoStream.FlushFinalBlock(); byte[] cipherBytes = memoryStream.ToArray(); return outputFormat.ToUpper() == "BASE64" ? Convert.ToBase64String(cipherBytes) : BitConverter.ToString(cipherBytes).Replace("-", "").ToLower(); // 输出小写Hex } } } /// <summary> /// DES解密 /// </summary> /// <param name="cipherText">待解密的密文</param> /// <param name="key">密钥，必须为8个字符</param> /// <param name="iv">初始向量，CBC模式时必须为8个字符，ECB模式时忽略</param> /// <param name="mode">加密模式，默认为CBC</param> /// <param name="inputFormat">输入密文的格式，Hex或Base64</param> /// <returns>解密后的明文字符串</returns> public static string Decrypt(string cipherText, string key, string iv = null, CipherMode mode = CipherMode.CBC, string inputFormat = "Hex") { if (string.IsNullOrEmpty(cipherText)) throw new ArgumentNullException(nameof(cipherText)); if (string.IsNullOrEmpty(key) || Encoding.UTF8.GetByteCount(key) != 8) throw new ArgumentException("DES密钥必须为8字节。", nameof(key)); if (mode == CipherMode.CBC && (string.IsNullOrEmpty(iv) || Encoding.UTF8.GetByteCount(iv) != 8)) throw new ArgumentException("CBC模式下的初始向量(IV)必须为8字节。", nameof(iv)); byte[] cipherBytes; if (inputFormat.ToUpper() == "BASE64") { cipherBytes = Convert.FromBase64String(cipherText); } else { // 处理Hex字符串 int length = cipherText.Length; cipherBytes = new byte[length / 2]; for (int i = 0; i < length; i += 2) { cipherBytes[i / 2] = Convert.ToByte(cipherText.Substring(i, 2), 16); } } using (DES des = DES.Create()) { des.Key = Encoding.UTF8.GetBytes(key); des.Mode = mode; des.Padding = PaddingMode.PKCS7; if (mode == CipherMode.CBC) { des.IV = Encoding.UTF8.GetBytes(iv); } using (var memoryStream = new MemoryStream(cipherBytes)) using (var cryptoStream = new CryptoStream(memoryStream, des.CreateDecryptor(), CryptoStreamMode.Read)) using (var streamReader = new StreamReader(cryptoStream, Encoding.UTF8)) { return streamReader.ReadToEnd(); } } } }

3.2 关键代码解析与实操要点

1. 密钥长度验证：Encoding.UTF8.GetByteCount(key) != 8这行代码至关重要。用户可能输入8个英文字母（8字节），也可能输入4个中文（约12字节）。DES算法要求密钥字节长度为8。这里我们强制校验，避免使用无效密钥导致加密强度减弱或运行时错误。在实际生产中，更安全的做法是使用密钥派生函数（如PBKDF2）从任意长度口令生成固定长度的密钥，但为了与Node.js简单库对齐，这里采用截断或校验方式。

2. using语句的重要性：DES、MemoryStream、CryptoStream等都实现了IDisposable接口。使用using语句确保即使在加密解密过程中发生异常，这些非托管资源也能被正确释放，避免内存泄漏。这是编写健壮C#代码的基本素养。

3. 填充模式明确指定：des.Padding = PaddingMode.PKCS7;虽然某些环境下可能是默认值，但显式指定可以消除任何不确定性，确保与Node.js端（通常也使用PKCS7）完全一致。

4. 输出格式灵活处理：提供了Hex和Base64两种输出。与Node.js通信时，强烈建议使用Base64，因为它更紧凑，而且是网络传输（如JSON）中的常客。Hex字符串更适合调试和肉眼比对。

5. CBC模式下的IV处理：代码中，只有当模式为CipherMode.CBC时，才校验并设置IV。在ECB模式下，设置IV是无效的。这符合算法规范，也避免了不必要的参数传递错误。

3.3 测试用例与验证

编写一个简单的控制台程序来测试我们的工具类，并生成用于Node.js端验证的测试数据。

class Program { static void Main(string[] args) { string originalText = "Hello, Node.js! 这是测试文本。"; string key = "8ByteKey"; // 正好8个ASCII字符 string iv = "12345678"; // CBC模式需要的IV Console.WriteLine("=== CBC模式测试 ==="); string encryptedCbc = DesHelper.Encrypt(originalText, key, iv, CipherMode.CBC, "Base64"); Console.WriteLine($"加密后 (Base64): {encryptedCbc}"); string decryptedCbc = DesHelper.Decrypt(encryptedCbc, key, iv, CipherMode.CBC, "Base64"); Console.WriteLine($"解密后: {decryptedCbc}"); Console.WriteLine($"加解密是否成功: {originalText == decryptedCbc}"); Console.WriteLine("\n=== ECB模式测试 ==="); // ECB模式不需要IV string encryptedEcb = DesHelper.Encrypt(originalText, key, mode: CipherMode.ECB, outputFormat: "Hex"); Console.WriteLine($"加密后 (Hex): {encryptedEcb}"); string decryptedEcb = DesHelper.Decrypt(encryptedEcb, key, mode: CipherMode.ECB, inputFormat: "Hex"); Console.WriteLine($"解密后: {decryptedEcb}"); Console.WriteLine($"加解密是否成功: {originalText == decryptedEcb}"); // 保存测试数据供Node.js使用 Console.WriteLine("\n--- 用于Node.js验证的测试数据 ---"); Console.WriteLine($"明文: {originalText}"); Console.WriteLine($"密钥: {key}"); Console.WriteLine($"IV (CBC): {iv}"); Console.WriteLine($"CBC密文 (Base64): {encryptedCbc}"); Console.WriteLine($"ECB密文 (Hex): {encryptedEcb}"); } }

运行这段代码，你会得到类似以下的输出。请务必记下你的key、iv、CBC密文和ECB密文，我们将在Node.js端用它们进行互操作测试。

=== CBC模式测试 === 加密后 (Base64): 9Hj5K7X8FvzTsm1LkP+oWm2NxYQ7bZcAeWpE4Rq7tG0= 解密后: Hello, Node.js! 这是测试文本。 加解密是否成功: True === ECB模式测试 === 加密后 (Hex): a1b2c3d4e5f678901234567890abcdef1234567890abcdefa1b2c3d4e5f67890 解密后: Hello, Node.js! 这是测试文本。 加解密是否成功: True --- 用于Node.js验证的测试数据 --- 明文: Hello, Node.js! 这是测试文本。 密钥: 8ByteKey IV (CBC): 12345678 CBC密文 (Base64): 9Hj5K7X8FvzTsm1LkP+oWm2NxYQ7bZcAeWpE4Rq7tG0= ECB密文 (Hex): a1b2c3d4e5f678901234567890abcdef1234567890abcdefa1b2c3d4e5f67890

4. Node.js端DES加密解密实现详解

Node.js内置了强大的crypto模块，无需安装第三方库即可实现DES加密。我们将实现一个与C#端功能完全对齐的工具模块。

4.1 核心工具模块封装

创建一个名为desCrypto.js的文件。

const crypto = require('crypto'); const util = require('util'); class DesHelper { /** * DES加密 * @param {string} plainText - 明文 * @param {string} key - 8字节密钥字符串 * @param {string} [iv] - 初始向量（CBC模式需要，8字节） * @param {string} [mode='CBC'] - 加密模式，'CBC' 或 'ECB' * @param {string} [outputFormat='hex'] - 输出格式，'hex' 或 'base64' * @returns {string} 密文 */ static encrypt(plainText, key, iv = null, mode = 'CBC', outputFormat = 'hex') { if (!plainText) throw new Error('plainText is required'); // 检查密钥字节长度 const keyBytes = Buffer.from(key, 'utf8'); if (keyBytes.length !== 8) { throw new Error('DES key must be 8 bytes in UTF-8 encoding.'); } let actualMode; let actualIv = null; if (mode.toUpperCase() === 'CBC') { actualMode = 'des-cbc'; if (!iv) throw new Error('IV is required for CBC mode.'); const ivBytes = Buffer.from(iv, 'utf8'); if (ivBytes.length !== 8) throw new Error('IV must be 8 bytes for DES.'); actualIv = ivBytes; } else if (mode.toUpperCase() === 'ECB') { actualMode = 'des-ecb'; // ECB模式不需要IV，即使传入也会被忽略 } else { throw new Error(`Unsupported mode: ${mode}. Use 'CBC' or 'ECB'.`); } const cipher = crypto.createCipheriv(actualMode, keyBytes, actualIv); // 注意：Node.js crypto默认使用PKCS7填充，这与C#端对齐 let encrypted = cipher.update(plainText, 'utf8', outputFormat); encrypted += cipher.final(outputFormat); return encrypted; } /** * DES解密 * @param {string} cipherText - 密文 * @param {string} key - 8字节密钥字符串 * @param {string} [iv] - 初始向量（CBC模式需要，8字节） * @param {string} [mode='CBC'] - 加密模式，'CBC' 或 'ECB' * @param {string} [inputFormat='hex'] - 输入密文格式，'hex' 或 'base64' * @returns {string} 明文 */ static decrypt(cipherText, key, iv = null, mode = 'CBC', inputFormat = 'hex') { if (!cipherText) throw new Error('cipherText is required'); const keyBytes = Buffer.from(key, 'utf8'); if (keyBytes.length !== 8) { throw new Error('DES key must be 8 bytes in UTF-8 encoding.'); } let actualMode; let actualIv = null; if (mode.toUpperCase() === 'CBC') { actualMode = 'des-cbc'; if (!iv) throw new Error('IV is required for CBC mode.'); const ivBytes = Buffer.from(iv, 'utf8'); if (ivBytes.length !== 8) throw new Error('IV must be 8 bytes for DES.'); actualIv = ivBytes; } else if (mode.toUpperCase() === 'ECB') { actualMode = 'des-ecb'; } else { throw new Error(`Unsupported mode: ${mode}. Use 'CBC' or 'ECB'.`); } const decipher = crypto.createDecipheriv(actualMode, keyBytes, actualIv); let decrypted = decipher.update(cipherText, inputFormat, 'utf8'); decrypted += decipher.final('utf8'); return decrypted; } } module.exports = DesHelper;

4.2 关键代码解析与实操要点

1. 使用createCipheriv而非createCipher：Node.js的crypto模块中，createCipher已废弃，因为它自动生成IV且行为不够明确，不利于跨语言对齐。createCipheriv要求显式提供密钥和IV，这让我们能完全控制加密过程，是实现互操作性的关键。

2. 算法标识符：'des-cbc'和'des-ecb'。这是Node.jscrypto模块识别DES算法的特定字符串。务必写对，'des'本身可能指向默认模式（通常是CBC），但显式指定更安全。

3. 缓冲区（Buffer）与编码：Buffer.from(key, 'utf8')将字符串密钥转换为字节缓冲区。这里同样校验字节长度是否为8。cipher.update()和final()方法的第二个参数指定输入编码，第三个参数指定输出编码，这让我们能轻松处理Hex和Base64格式。

4. 默认填充：Node.js的crypto模块在DES算法上默认使用PKCS7填充，这与我们C#端的设置一致。这是实现互操作的另一大幸事，无需额外配置。

5. 错误处理：代码中对密钥长度、IV、模式等进行了校验，并抛出明确的错误信息。在生产环境中，你可能需要更优雅的错误处理，但清晰的错误提示对于调试至关重要。

4.3 测试用例与跨语言验证

现在，我们编写测试脚本，使用从C#端得到的测试数据进行验证。

// testDes.js const DesHelper = require('./desCrypto.js'); // 使用C#测试程序生成的相同数据 const originalText = "Hello, Node.js! 这是测试文本。"; const key = "8ByteKey"; const iv = "12345678"; const cbcCipherTextBase64 = "9Hj5K7X8FvzTsm1LkP+oWm2NxYQ7bZcAeWpE4Rq7tG0="; // 替换为你的C# CBC密文 const ecbCipherTextHex = "a1b2c3d4e5f678901234567890abcdef1234567890abcdefa1b2c3d4e5f67890"; // 替换为你的C# ECB密文 console.log("=== 验证CBC模式（Base64）==="); try { const decryptedCbc = DesHelper.decrypt(cbcCipherTextBase64, key, iv, 'CBC', 'base64'); console.log(`Node.js解密结果: ${decryptedCbc}`); console.log(`与C#明文是否一致: ${originalText === decryptedCbc}`); // 再用Node.js加密一次，看是否能得到相同密文 const reEncryptedCbc = DesHelper.encrypt(originalText, key, iv, 'CBC', 'base64'); console.log(`Node.js重新加密 (Base64): ${reEncryptedCbc}`); console.log(`与C#密文是否一致: ${cbcCipherTextBase64 === reEncryptedCbc}`); } catch (err) { console.error("CBC模式验证失败:", err.message); } console.log("\n=== 验证ECB模式（Hex）==="); try { const decryptedEcb = DesHelper.decrypt(ecbCipherTextHex, key, null, 'ECB', 'hex'); console.log(`Node.js解密结果: ${decryptedEcb}`); console.log(`与C#明文是否一致: ${originalText === decryptedEcb}`); const reEncryptedEcb = DesHelper.encrypt(originalText, key, null, 'ECB', 'hex'); console.log(`Node.js重新加密 (Hex): ${reEncryptedEcb}`); console.log(`与C#密文是否一致: ${ecbCipherTextHex === reEncryptedEcb}`); } catch (err) { console.error("ECB模式验证失败:", err.message); } console.log("\n=== 综合测试：Node.js加密，C#解密（假设）==="); const nodeEncrypted = DesHelper.encrypt("Message from Node.js", key, iv, 'CBC', 'base64'); console.log(`Node.js生成密文: ${nodeEncrypted}`); console.log(`你可以将此密文和密钥('${key}')、IV('${iv}')提供给C#端进行解密验证。`);

运行这个测试脚本：node testDes.js。如果一切配置正确，你将看到所有“是否一致”的检查结果都为true。这标志着C#与Node.js之间的DES加密解密通道已成功打通！

5. 高级话题：3DES的实现与注意事项

虽然项目标题聚焦DES，但3DES（Triple DES）作为DES的直接增强版，在实际应用中也很常见，尤其是在一些需要兼容旧系统的场景。3DES简单地说是用DES算法对每个数据块进行三次加密，通常使用两个或三个不同的密钥（K1, K2, K3），加密过程为：加密(K1) -> 解密(K2) -> 加密(K3)。当K1=K2=K3时，就退化为普通的DES，提供了向后兼容性。

5.1 C#中的3DES实现

在C#中，我们使用TripleDESCryptoServiceProvider。需要注意的是，3DES的密钥长度应为24字节（192位），IV仍为8字节。

public static class TripleDesHelper { public static string Encrypt(string plainText, string key24, string iv8, CipherMode mode = CipherMode.CBC, string outputFormat = "Base64") { // 参数校验略，类似DES using (TripleDES des = TripleDES.Create()) { des.Key = Encoding.UTF8.GetBytes(key24); des.IV = Encoding.UTF8.GetBytes(iv8); des.Mode = mode; des.Padding = PaddingMode.PKCS7; using (var ms = new MemoryStream()) using (var cs = new CryptoStream(ms, des.CreateEncryptor(), CryptoStreamMode.Write)) { byte[] data = Encoding.UTF8.GetBytes(plainText); cs.Write(data, 0, data.Length); cs.FlushFinalBlock(); byte[] encrypted = ms.ToArray(); return outputFormat.ToUpper() == "HEX" ? BitConverter.ToString(encrypted).Replace("-", "") : Convert.ToBase64String(encrypted); } } } // 解密方法类似，略 }

重要警告：TripleDESCryptoServiceProvider对密钥有弱密钥检查。如果你提供的24字节密钥中，前8字节和后8字节相同，或者三个8字节段都相同，可能会抛出“Specified key is a known weak key”异常。这是算法本身的安全特性，并非代码错误。应使用密码学安全的随机数生成器生成密钥。

5.2 Node.js中的3DES实现

Node.js的crypto模块同样支持3DES，算法标识符为'des-ede3-cbc'（用于三个独立密钥的CBC模式）或'des-ede3'（ECB模式）。对于双密钥的3DES（K1, K2, K1），有对应的'des-ede-cbc'。

static encrypt3Des(plainText, key24, iv8, mode = 'CBC', outputFormat = 'base64') { const keyBytes = Buffer.from(key24, 'utf8'); if (keyBytes.length !== 24) throw new Error('3DES key must be 24 bytes.'); const ivBytes = Buffer.from(iv8, 'utf8'); if (ivBytes.length !== 8) throw new Error('IV must be 8 bytes.'); const algorithm = mode.toUpperCase() === 'CBC' ? 'des-ede3-cbc' : 'des-ede3'; const cipher = crypto.createCipheriv(algorithm, keyBytes, ivBytes); let encrypted = cipher.update(plainText, 'utf8', outputFormat); encrypted += cipher.final(outputFormat); return encrypted; }

确保C#和Node.js使用相同的密钥长度（24字节）、IV长度（8字节）、模式（CBC/ECB）和填充（PKCS7），3DES的互操作性也能轻松实现。

6. 实战避坑指南与常见问题排查

即使按照上述步骤操作，在实际集成中你可能还是会遇到一些问题。下面是我在多年跨系统集成中总结的“避坑清单”和排查方法。

6.1 问题排查流程图

当你遇到“解密失败”或“结果不一致”时，可以按以下步骤排查：

1. 密文能正确解码吗？ ├─ 否：检查输出/输入格式（Hex vs Base64）是否匹配。Base64密文通常以`=`结尾，Hex是纯0-9a-f。 └─ 是：进入下一步。 2. 密钥和IV的字节表示一致吗？ ├─ 不一致：检查字符串编码。双方都必须使用UTF-8将字符串转换为字节。一个中文在C#和Node.js的UTF-8编码下应该是相同的字节序列。使用`Encoding.UTF8.GetBytes`和`Buffer.from(str, 'utf8')`进行验证。 └─ 一致：进入下一步。 3. 加密模式（Cipher Mode）一致吗？ ├─ 不一致：一方用CBC，另一方用ECB，必然失败。确认双方模式设置。 └─ 一致：进入下一步。 4. 填充模式（Padding Mode）一致吗？ └─ 这是最隐蔽的坑！C#默认可能是PKCS7，Node.js crypto默认也是PKCS7，但如果你用的其他Node.js库（如`crypto-js`）或C#里改了设置，就可能不一致。确保双方都是PKCS7。 5. 初始向量（IV）处理正确吗？ ├─ CBC模式：必须提供相同的8字节IV。ECB模式：必须不提供或忽略IV。 └─ 检查IV的生成和传递逻辑。如果C#每次加密使用随机IV，那么必须将IV和密文一起传给Node.js才能解密。

6.2 常见问题速查表

6.3 关键实操心得

1. 统一使用Base64：在网络传输和JSON序列化中，Base64比Hex更通用、更紧凑。将outputFormat和inputFormat默认设为'base64'能减少很多麻烦。

2. IV需要随机且同步：对于CBC模式，为了提高安全性，每次加密都应使用随机生成的IV。但这意味着你必须将这个IV（不需要加密）和密文一起存储或传输给解密方。常见的做法是将IV拼接在密文前面（例如，前8个字节是IV，后面是密文），或者作为另一个字段一起发送。

3. 不要自己实现加密算法：绝对不要尝试自己写DES的加密解密逻辑。使用经过严格审计的标准库（如.NET的System.Security.Cryptography和Node.js的crypto）。密码学非常复杂，细微的错误就会导致严重的安全漏洞。

4. DES已过时，用于学习或遗留系统：再次强调，DES和3DES已经不被认为对强大的攻击者安全。对于新的系统，请使用AES（高级加密标准）。AES在.NET和Node.js中也有很好的支持，且互操作性的对齐原则（模式、填充、密钥IV处理）与本文所述完全相通。当你掌握了DES的跨语言互操作，迁移到AES会非常容易。

7. 从DES平滑过渡到AES的建议

虽然本文主题是DES，但作为负责任的开发者，我必须指出在新项目中应使用AES-256。这里给出一个快速的AES互操作要点，作为你未来项目的参考。

1. 算法标识符：

   • C#: 使用Aes.Create()。
   • Node.js: 使用算法字符串如'aes-256-cbc'。其中的256指密钥长度（位）。

2. 密钥和IV长度：

   • AES-128: 密钥16字节，IV 16字节。
   • AES-192: 密钥24字节，IV 16字节。
   • AES-256: 密钥32字节，IV 16字节。

3. 代码调整：将本文中所有的DES/TripleDES类名和算法标识符替换为AES对应的，并调整密钥和IV的长度校验，其余逻辑（模式、填充、编码）几乎可以复用。

4. 更佳实践：考虑使用经过封装的、更安全的操作模式，如GCM（Galois/Counter Mode），它不仅提供保密性，还提供完整性认证。在Node.js中对应'aes-256-gcm'，在C#中设置AesGcm模式。

实现跨语言加密解密互操作，核心在于“对齐”二字。就像两个说不同母语的人要协作，必须找到一套共同的、精确的协议。通过本文对DES算法配置（模式、填充、密钥IV、输出格式）的深度剖析和C#/Node.js两端的完整实现，你已经掌握了这套协议的精髓。无论你面对的是DES、3DES还是AES，这套排查和解决问题的思路都是通用的。记住，密码学是严谨的科学，差之毫厘，谬以千里。在联调时，耐心地、逐个参数地比对，你一定能成功打通这条安全的数据通道。