您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Java MD5 加密完整指南：三種實作方式、效能比較與安全最佳實踐

編輯：Java 相關知識

前言

MD5 (Message Digest Algorithm 5) 是廣泛使用的雜湊函數，雖已不適合密碼學安全場景，但在檔案完整性校驗、非安全標識生成、快取鍵值等領域仍有廣泛應用。本文提供三種 Java 實作方式、效能基準測試、安全性分析與遷移建議。

MD5 基礎知識

屬性	值
輸出長度	128 bits (16 bytes / 32 hex chars)
演算法類型	單向雜湊函數
碰撞抗性	已破解 (2004 年王小雲團隊)
預像抗性	理論安全，但計算成本極低
Java 提供者	SunJCE (預設)、BouncyCastle

三種實作方式

方式一：標準 MessageDigest API (推薦)


import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class Md5Util {
    private static final char[] HEX_DIGITS = "0123456789abcdef".toCharArray();
    
    public static String md5(String input) {
        return md5(input.getBytes(StandardCharsets.UTF_8));
    }
    
    public static String md5(byte[] input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input);
            return bytesToHex(digest);
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalStateException("MD5 algorithm not available", e);
        }
    }
    
    // 高效能十六進位轉換 (避免 StringBuilder 擴容)
    private static String bytesToHex(byte[] bytes) {
        char[] result = new char[bytes.length * 2];
        for (int i = 0, j = 0; i < bytes.length; i++) {
            byte b = bytes[i];
            result[j++] = HEX_DIGITS[(b >> 4) & 0xF];
            result[j++] = HEX_DIGITS[b & 0xF];
        }
        return new String(result);
    }
    
    // 檔案 MD5 (流式處理，避免載入整個檔案)
    public static String md5File(Path file) throws IOException {
        try (InputStream is = Files.newInputStream(file)) {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] buffer = new byte[8192];
            int read;
            while ((read = is.read(buffer)) != -1) {
                md.update(buffer, 0, read);
            }
            return bytesToHex(md.digest());
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalStateException(e);
        }
    }
}

方式二：Apache Commons Codec (生產常用)




    commons-codec
    commons-codec
    1.16.0


// 使用
import org.apache.commons.codec.digest.DigestUtils;

public class Md5Commons {
    public static String md5(String input) {
        return DigestUtils.md5Hex(input.getBytes(StandardCharsets.UTF_8));
    }
    
    public static String md5File(File file) throws IOException {
        try (FileInputStream fis = new FileInputStream(file)) {
            return DigestUtils.md5Hex(fis);
        }
    }
}

方式三：Guava Hashing (現代化 API)




    com.google.guava
    guava
    32.1.3-jre


// 使用
import com.google.common.hash.Hashing;

public class Md5Guava {
    public static String md5(String input) {
        return Hashing.md5()
            .hashString(input, StandardCharsets.UTF_8)
            .toString();
    }
    
    public static String md5Bytes(byte[] input) {
        return Hashing.md5().hashBytes(input).toString();
    }
}

效能基準測試 (JMH)


@BenchmarkMode(Mode.Throughput)
@OutputTimeUnit(TimeUnit.SECONDS)
@State(Scope.Thread)
@Warmup(iterations = 3, time = 1)
@Measurement(iterations = 5, time = 1)
@Fork(1)
public class Md5Benchmark {
    
    @Param({"100", "1000", "10000"})
    int inputSize;
    
    byte[] input;
    
    @Setup
    public void setup() {
        input = new byte[inputSize];
        new Random().nextBytes(input);
    }
    
    @Benchmark
    public String jdkMd5() {
        return Md5Util.md5(input);
    }
    
    @Benchmark
    public String commonsMd5() {
        return Md5Commons.md5(new String(input, StandardCharsets.UTF_8));
    }
    
    @Benchmark
    public String guavaMd5() {
        return Md5Guava.md5Bytes(input);
    }
}

典型測試結果 (ops/s, 較高越好)

輸入大小	JDK 原生	Commons Codec	Guava	勝出者
100 bytes	~2,800,000	~2,600,000	~2,500,000	JDK 原生
1 KB	~450,000	~420,000	~400,000	JDK 原生
10 KB	~55,000	~52,000	~50,000	JDK 原生

結論：JDK 原生效能最佳，無額外依賴。Commons Codec/Guava 差異 < 10%，主要優勢在 API 易用性與跨平台一致性。

安全性分析與遷移建議

MD5 不安全的場景

場景	風險	建議替代
密碼儲存	彩虹表、GPU 破解、碰撞攻擊	BCrypt, Argon2, PBKDF2, Scrypt
Token/Session ID 生成	可預測、碰撞	SecureRandom + Base64, UUID
數位簽名/完整性驗證	碰撞攻擊可偽造	SHA-256, SHA-3, BLAKE2
SSL/TLS 憑證	已禁用	SHA-256+

MD5 仍可接受的場景

檔案完整性校驗 (非安全關鍵，如下載驗證)
資料庫主鍵/快取鍵生成 (非敏感業務標識)
非安全系統的簡單去重
相容舊系統整合

密碼儲存最佳實踐 (BCrypt 範例)




    org.mindrot
    jbcrypt
    0.4


// 使用
import org.mindrot.jbcrypt.BCrypt;

public class PasswordUtil {
    // 成本因子 12 (約 250ms/次，可根據硬體調整 10-14)
    private static final int COST = 12;
    
    public static String hash(String plainPassword) {
        return BCrypt.hashpw(plainPassword, BCrypt.gensalt(COST));
    }
    
    public static boolean verify(String plainPassword, String hashed) {
        return BCrypt.checkpw(plainPassword, hashed);
    }
}

進階用法

1. 帶 Salt 的 MD5 (僅相容舊系統)


public class SaltedMd5 {
    private static final SecureRandom RANDOM = new SecureRandom();
    
    public static String generateSalt() {
        byte[] salt = new byte[16];
        RANDOM.nextBytes(salt);
        return Md5Util.bytesToHex(salt);
    }
    
    public static String md5WithSalt(String input, String saltHex) {
        byte[] salt = Md5Util.hexToBytes(saltHex);
        byte[] inputBytes = input.getBytes(StandardCharsets.UTF_8);
        byte[] combined = new byte[salt.length + inputBytes.length];
        System.arraycopy(salt, 0, combined, 0, salt.length);
        System.arraycopy(inputBytes, 0, combined, salt.length, inputBytes.length);
        return Md5Util.md5(combined);
    }
    
    public static boolean verify(String input, String saltHex, String expectedMd5) {
        return md5WithSalt(input, saltHex).equals(expectedMd5);
    }
}

2. 大檔案流式計算 (避免 OOM)


public class LargeFileMd5 {
    public static String calculate(Path file) throws IOException {
        try (InputStream is = Files.newInputStream(file)) {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] buffer = new byte[1024 * 1024]; // 1MB buffer
            int read;
            while ((read = is.read(buffer)) != -1) {
                md.update(buffer, 0, read);
            }
            return Md5Util.bytesToHex(md.digest());
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalStateException(e);
        }
    }
    
    // 並行計算多個檔案
    public static Map calculateParallel(List files) throws InterruptedException, ExecutionException {
        try (ExecutorService executor = Executors.newFixedThreadPool(
                Math.min(files.size(), Runtime.getRuntime().availableProcessors()))) {
            
            List>> futures = files.stream()
                .map(file -> CompletableFuture.supplyAsync(() -> {
                    try {
                        return Map.entry(file, calculate(file));
                    } catch (IOException e) {
                        throw new CompletionException(e);
                    }
                }, executor))
                .collect(Collectors.toList());
            
            return futures.stream()
                .map(CompletableFuture::join)
                .collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue));
        }
    }
}

3. 效能優化：重用 MessageDigest (執行緒不安全)


public class ThreadLocalMd5 {
    private static final ThreadLocal MD5_DIGEST = ThreadLocal.withInitial(() -> {
        try {
            return MessageDigest.getInstance("MD5");
        } catch (NoSuchAlgorithmException e) {
            throw new IllegalStateException(e);
        }
    });
    
    public static String md5(byte[] input) {
        MessageDigest md = MD5_DIGEST.get();
        md.reset();
        return Md5Util.bytesToHex(md.digest(input));
    }
}

常見問題

Q: 為什麼同樣輸入，不同工具輸出大小寫不同？: A: MD5 標準未規定大小寫。Java 通常輸出小寫，某些工具輸出大寫。比對時統一轉小寫。
Q: 如何驗證檔案下載完整性？: A: 下載後計算 MD5，與官方提供的 MD5 比對 (忽略大小寫)。
Q: MessageDigest 是執行緒安全的嗎？: A: 不是。多執行緒需各自實例或使用 ThreadLocal。
Q: 為什麼不建議用 MD5 做快取鍵？: A: 碰撞風險雖低但存在。建議用 SHA-256 或直接用原始字串 (長度允許時)。

總結

Java 實現 MD5 首選 JDK 原生 MessageDigest，無依賴、效能最佳。嚴禁用於密碼儲存、Token 生成、安全簽名。密碼請用 BCrypt/Argon2，完整性驗證請用 SHA-256，Token 請用 SecureRandom。理解 MD5 的定位邊界，是開發者基本的安全素養。