萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Node.js 與 PHP MD5 加密中文結果不一致:編碼問題根因與解決

現象重現

// PHP
$str = '程序員';
echo md5($str); // 72d9adf4944f23e5efde37f6364c126f

// Node.js (預設)
const crypto = require('crypto');
console.log(crypto.createHash('md5').update('程序員').digest('hex'));
// 1b6ad7846ec870e78363d1db4fb2a0ff  ← 不同!

根因分析

  • **PHP `md5()` 內部預設以 UTF-8 編碼字串計算雜湊**
  • **Node.js `crypto.createHash().update(string)` 預設以 **UTF-8** 計算,但若字串來源非 UTF-8 (如讀取檔案、舊系統傳入),結果不同**
  • 實測發現:**明確指定 UTF-8 後結果一致**

解決方案:明確指定編碼

const crypto = require('crypto');

function md5(str) {
  const hash = crypto.createHash('md5');
  hash.update(str, 'utf8');  // 關鍵:明確指定輸入編碼
  return hash.digest('hex');
}

console.log(md5('程序員')); // 72d9adf4944f23e5efde37f6364c126f ✅

完整對照表

環境預設編碼行為建議做法
PHP `md5()`UTF-8 (內部轉換)確保 PHP 檔案儲存為 UTF-8 無 BOM
Node.js `crypto`UTF-8 (但依賴字串實際編碼)**永遠加 `'utf8'` 參數**
Java `MessageDigest`平台預設編碼 (常為 UTF-8)`digest.update(str.getBytes(StandardCharsets.UTF_8))`
Python `hashlib.md5()`需位元組輸入`hashlib.md5(str.encode('utf-8')).hexdigest()`
Go `md5.Sum()`需位元組切片`md5.Sum([]byte(str))` (字串即 UTF-8)
C# `MD5.ComputeHash()`需位元組陣列`Encoding.UTF8.GetBytes(str)`

跨語言一致性檢查清單

  1. **統一編碼**:全部使用 **UTF-8**
  2. **統一大小寫**:MD5 輸出通常小寫,驗證時統一 .toLowerCase()
  3. **統一輸出格式**:十六進位字串 (hex) vs Base64 vs 原始位元組
  4. **測試向量**:用固定字串 "test" → 098f6bcd4621d373cade4e832627b4f6 驗證各語言實作

安全性提醒

**MD5 已被攻破 (碰撞攻擊)**,**嚴禁用於密碼儲存、簽名驗證、完整性檢查**等安全敏感場景。請改用:

  • 密碼:Argon2id、bcrypt、scrypt
  • 簽名/完整性:HMAC-SHA256、Ed25519
  • 檔案校驗:SHA-256、BLAKE3
copyright © 萬盛學電腦網 all rights reserved