在Java开发中，计算文件的MD5与SHA哈希值是验证文件完整性、实现文件去重等场景的常用操作，核心依赖Java内置的MessageDigest类完成哈希计算，无需引入第三方依赖即可实现相关功能。
核心依赖类介绍
Java的java.security.MessageDigest类提供了消息摘要算法的功能，支持MD5、SHA1、SHA256、SHA512等多种哈希算法，是计算文件哈希值的核心类。使用时需要先通过getInstance方法获取对应算法的实例，再通过update方法传入数据，最后通过digest方法获取哈希结果。
计算文件MD5哈希值实现
计算文件MD5的步骤分为四步：获取MD5算法的MessageDigest实例、读取文件内容并分批次更新到摘要中、计算最终摘要、将字节数组转换为十六进制字符串。以下是完整实现代码：
import java.io.FileInputStream;
import java.io.IOException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class FileHashUtil {
/**
* 计算文件的MD5哈希值
* @param filePath 文件路径
* @return MD5哈希值的十六进制字符串，计算失败返回null
*/
public static String getFileMD5(String filePath) {
try (FileInputStream fis = new FileInputStream(filePath)) {
// 获取MD5算法的MessageDigest实例
MessageDigest digest = MessageDigest.getInstance("MD5");
byte[] buffer = new byte[8192];
int len;
// 分批次读取文件内容，更新摘要
while ((len = fis.read(buffer)) != -1) {
digest.update(buffer, 0, len);
}
// 计算最终摘要
byte[] hashBytes = digest.digest();
// 将字节数组转换为十六进制字符串
return bytesToHex(hashBytes);
} catch (IOException | NoSuchAlgorithmException e) {
e.printStackTrace();
return null;
}
}
/**
* 字节数组转十六进制字符串
* @param bytes 字节数组
* @return 十六进制字符串
*/
private static String bytesToHex(byte[] bytes) {
StringBuilder hexString = new StringBuilder();
for (byte b : bytes) {
// 将字节转换为无符号整数，再格式化为两位十六进制
String hex = Integer.toHexString(0xff & b);
if (hex.length() == 1) {
hexString.append('0');
}
hexString.append(hex);
}
return hexString.toString();
}
}
计算文件SHA哈希值实现
SHA系列哈希算法的实现逻辑和MD5基本一致，仅需要在获取MessageDigest实例时传入对应的算法名称即可，常见的SHA算法包括SHA1、SHA256、SHA512，以下是通用实现方法：
import java.io.FileInputStream;
import java.io.IOException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class FileHashUtil {
/**
* 计算文件的SHA哈希值
* @param filePath 文件路径
* @param algorithm 哈希算法，如SHA-1、SHA-256、SHA-512
* @return 哈希值的十六进制字符串，计算失败返回null
*/
public static String getFileSHA(String filePath, String algorithm) {
try (FileInputStream fis = new FileInputStream(filePath)) {
// 获取对应SHA算法的MessageDigest实例
MessageDigest digest = MessageDigest.getInstance(algorithm);
byte[] buffer = new byte[8192];
int len;
while ((len = fis.read(buffer)) != -1) {
digest.update(buffer, 0, len);
}
byte[] hashBytes = digest.digest();
return bytesToHex(hashBytes);
} catch (IOException | NoSuchAlgorithmException e) {
e.printStackTrace();
return null;
}
}
/**
* 字节数组转十六进制字符串
* @param bytes 字节数组
* @return 十六进制字符串
*/
private static String bytesToHex(byte[] bytes) {
StringBuilder hexString = new StringBuilder();
for (byte b : bytes) {
String hex = Integer.toHexString(0xff & b);
if (hex.length() == 1) {
hexString.append('0');
}
hexString.append(hex);
}
return hexString.toString();
}
}
不同哈希算法对比
不同的哈希算法在安全性和性能上存在差异，开发者可以根据实际需求选择：
| 算法名称 | 哈希长度（位） | 安全性 | 适用场景 |
|---|---|---|---|
| MD5 | 128 | 较低，已被证明存在碰撞漏洞 | 非安全场景的文件完整性校验、简单去重 |
| SHA1 | 160 | 中等，存在理论碰撞可能 | 一般场景的文件校验 |
| SHA256 | 256 | 较高，目前无已知有效攻击 | 安全敏感场景的文件校验、数字签名 |
| SHA512 | 512 | 高 | 对安全性要求极高的场景 |
使用示例
调用上述方法计算文件哈希值的示例如下：
public class Test {
public static void main(String[] args) {
String filePath = "D:/test.txt";
// 计算文件MD5
String md5 = FileHashUtil.getFileMD5(filePath);
System.out.println("文件MD5：" + md5);
// 计算文件SHA256
String sha256 = FileHashUtil.getFileSHA(filePath, "SHA-256");
System.out.println("文件SHA256：" + sha256);
// 计算文件SHA1
String sha1 = FileHashUtil.getFileSHA(filePath, "SHA-1");
System.out.println("文件SHA1：" + sha1);
}
}
注意事项
- 读取大文件时建议使用缓冲区分批次读取，避免一次性将文件加载到内存导致内存溢出，上述代码中使用8192字节的缓冲区是通用选择。
- 计算哈希值前需要确认文件存在且有读取权限，否则会抛出IO异常。
- 如果用于安全场景，不建议使用MD5和SHA1算法，优先选择SHA256及以上长度的算法。
- 转换十六进制字符串时需要注意补位，保证每个字节对应两位十六进制字符，避免结果错误。
JavaMD5SHA文件哈希MessageDigest修改时间：2026-06-14 11:54:36