前後端都要計算 MD5 時(例如前端先算摘要再傳給後端核對),最常見的問題是「同一個字串,兩邊算出來不一樣」。原因通常是編碼差異。本文整理兩端的實作,並說明如何避免這個坑。
package org.bearfly.test.md5;
import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class MD5Utils {
public static void main(String[] args) {
System.out.println(getMd5String(""));
System.out.println(MD5("good"));
}
public final static String MD5(String s) {
char hexDigits[] = { '0','1','2','3','4','5','6','7',
'8','9','A','B','C','D','E','F' };
try {
byte[] btInput = s.getBytes();
// 取得 MD5 摘要算法的 MessageDigest 物件
MessageDigest mdInst = MessageDigest.getInstance("MD5");
// 使用指定的位元組更新摘要
mdInst.update(btInput);
// 取得密文
byte[] md = mdInst.digest();
// 把密文轉成十六進位字串
int j = md.length;
char str[] = new char[j * 2];
int k = 0;
for (int i = 0; i < j; i++) {
byte byte0 = md[i];
str[k++] = hexDigits[byte0 >>> 4 & 0xf];
str[k++] = hexDigits[byte0 & 0xf];
}
return new String(str);
} catch (Exception e) {
e.printStackTrace();
return null;
}
}
public static String getMd5String(String str) {
MessageDigest messageDigest = null;
try {
messageDigest = MessageDigest.getInstance("MD5");
messageDigest.reset();
messageDigest.update(str.getBytes("UTF-8"));
} catch (NoSuchAlgorithmException e) {
System.out.println("NoSuchAlgorithmException caught!");
System.exit(-1);
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
byte[] byteArray = messageDigest.digest();
StringBuffer md5StrBuff = new StringBuffer();
for (int i = 0; i < byteArray.length; i++) {
if (Integer.toHexString(0xFF & byteArray[i]).length() == 1) {
md5StrBuff.append("0").append(Integer.toHexString(0xFF & byteArray[i]));
} else {
md5StrBuff.append(Integer.toHexString(0xFF & byteArray[i]));
}
}
return md5StrBuff.toString();
}
}
這段程式碼示範了兩個寫法。MD5 方法用 s.getBytes() 未指定編碼,會採用平台預設編碼,這在跨環境時可能出問題,且回傳大寫。getMd5String 方法明確指定 UTF-8,並回傳小寫,是比較可靠的版本。
早期做法是引入一份 md5.js 函式庫。它的對外介面通常長這樣:
var hexcase = 0; /* hex 輸出格式:0 小寫,1 大寫 */
var b64pad = ""; /* base-64 補位字元 */
var chrsz = 8; /* 每個輸入字元的位元數:8 為 ASCII,16 為 Unicode */
function hex_md5(s) { return binl2hex(core_md5(str2binl(s), s.length * chrsz)); }
function b64_md5(s) { return binl2b64(core_md5(str2binl(s), s.length * chrsz)); }
function str_md5(s) { return binl2str(core_md5(str2binl(s), s.length * chrsz)); }
function hex_hmac_md5(key, data) { return binl2hex(core_hmac_md5(key, data)); }
function b64_hmac_md5(key, data) { return binl2b64(core_hmac_md5(key, data)); }
function str_hmac_md5(key, data) { return binl2str(core_hmac_md5(key, data)); }
// 自我測試,確認執行環境正常
function md5_vm_test() {
return hex_md5("abc") == "900150983cd24fb0d6963f7d28e17f72";
}
核心的 core_md5 函式實作 MD5 的四輪壓縮(md5_ff、md5_gg、md5_hh、md5_ii 分別對應 F、G、H、I 四個非線性函式),並搭配 safe_add(32 位元加法溢位處理)、bit_rol(位元左旋轉)、str2binl(字串轉小端序整數陣列)、binl2hex(轉十六進位)等輔助函式。這些是 MD5 演算法的標準組成,各大函式庫的實作內容一致。
<html>
<head>
<title>md5_Test</title>
<script type="text/javascript" src="md5.js"></script>
</head>
<body>
<script type="text/javascript">
document.write("myPassword MD5: ", hex_md5("md5Test").toUpperCase());
</script>
</body>
</html>
MD5 的輸入是位元組,不是字元。同一個字串,用不同編碼轉成位元組,結果完全不同:
s.getBytes() 不指定編碼時,會用平台預設(可能是 GBK、Big5、UTF-8)。chrsz = 8 表示按 ASCII 處理,非 ASCII 字元的高位元組會被靜默丟棄。因此含中文時,兩端極可能算出不同結果。解法是兩邊都明確指定 UTF-8:Java 用 s.getBytes("UTF-8")(或 StandardCharsets.UTF_8),JavaScript 則先把字串轉成 UTF-8 位元組序列。
另一個常見差異是大小寫。Java 範例中的 MD5 方法回傳大寫,JavaScript 預設回傳小寫,比對前要統一。
瀏覽器端不必再自己實作 MD5。Web Crypto API 是原生標準方案:
async function md5Hex(str) {
const buf = await crypto.subtle.digest('MD5', new TextEncoder().encode(str));
return [...new Uint8Array(buf)]
.map(b => b.toString(16).padStart(2, '0'))
.join('');
}
md5Hex("md5Test").then(console.log);
TextEncoder 一律輸出 UTF-8,從根本上排除了編碼歧義。注意 Web Crypto 只在 HTTPS 或 localhost 下可用,且 digest 支援的演算法依瀏覽器而異(MD5 並非所有實作都提供,SHA 系列則普遍支援)。若不確定,用成熟的函式庫如 js-md5、crypto-js 會更穩妥。
Java 端也有簡潔寫法:
MessageDigest md = MessageDigest.getInstance("MD5");
byte[] digest = md.digest(str.getBytes(StandardCharsets.UTF_8));
String hex = HexFormat.of().formatHex(digest); // Java 17+
MD5 已被證明存在實質的碰撞弱點,不應用於任何安全用途。它速度快、抗日碰撞能力低落這兩點,讓它完全無法抵禦現代硬體的暴力搜尋。
若目的是「校驗資料傳輸是否完整」,MD5 還能勉強勝任,但 SHA-256 更好且成本相近。若目的是「儲存使用者密碼」,必須使用專門設計的慢雜湊函式:bcrypt、scrypt、Argon2 或 PBKDF2,並搭配隨機 salt。前端計算密碼雜湊也不增加安全性——傳輸必須靠 HTTPS,雜湊必須在伺服器端以慢雜湊進行。