本文介绍如何利用 DigestInputStream 在一次流读取过程中同步实现文件复制与哈希值计算，避免重复 I/O，显著提升性能并简化代码逻辑。
本文介绍如何利用 `digestinputstream` 在一次流读取过程中同步实现文件复制与哈希值计算，避免重复 i/o，显著提升性能并简化代码逻辑。
在 Java 文件处理中，常见需求是：将一个 InputStream 的内容保存到磁盘（如通过 FileUtils.copyInputStreamToFile），同时计算其 SHA-256 校验和。若分别执行两次读取（先算哈希再复制，或反之），不仅效率低下（尤其对大文件），还可能因流不可重置（如网络流、管道流）而失败。
幸运的是，Java 标准库提供了优雅的解决方案——java.security.DigestInputStream。它是一个装饰器（Decorator）类，包装原始 InputStream，在每次 read() 调用时自动将读取的数据喂给内部的 MessageDigest，从而实现「边读边摘要」。
以下是一个完整、可复用的实现示例：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
import java.io.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HexFormat;
public class Uploader {
private static final String SHA_256 = "SHA-256";
private final File targetFile;
public Uploader(File targetFile) {
this.targetFile = targetFile;
}
/**
* 同步完成流复制与 SHA-256 计算，返回十六进制格式校验和
* @param inputStream 待处理的输入流（调用后将被关闭）
* @return SHA-256 哈希值的十六进制字符串（小写，无分隔符）
* @throws IOException 若 I/O 异常
*/
public String transferAndHash(InputStream inputStream) throws IOException {
try {
MessageDigest md = MessageDigest.getInstance(SHA_256);
// 包装原始流，使其具备自动摘要能力
try (DigestInputStream digestIn = new DigestInputStream(inputStream, md)) {
// 复用原有复制逻辑（此处使用标准 Files.copy；也可替换为 FileUtils.copyInputStreamToFile）
Files.copy(digestIn, targetFile.toPath(),
java.nio.file.StandardCopyOption.REPLACE_EXISTING);
}
// 摘要计算完成，生成最终哈希值
return HexFormat.of().formatHex(md.digest());
} catch (NoSuchAlgorithmException e) {
throw new UnsupportedOperationException("JVM 不支持 SHA-256 算法", e);
}
}
}✅ 关键要点说明：
立即学习“Java免费学习笔记（深入）”；
- DigestInputStream 是线程不安全的，但本场景中单线程顺序读取完全适用；
- 流必须被完整读取（如 transferTo()、readAllBytes() 或 Files.copy()），否则 digest() 返回的是中间状态，结果错误；
- HexFormat.of().formatHex() 自 Java 17 起可用；若使用 Java 8–16，可改用 Apache Commons Codec 的 Hex.encodeHexString(md.digest())，或手动实现十六进制转换；
- 不要尝试在 DigestInputStream 外部再读取原始 inputStream——它已被包装，直接操作原始流将绕过摘要逻辑，导致哈希失效；
- 若目标是写入 OutputStream（如上传到远程服务），可考虑 DigestOutputStream 配合 transferTo() 写入，原理对称。
? 最佳实践建议：
始终将 DigestInputStream 放入 try-with-resources 中，并确保其 close() 被调用（这会触发底层流关闭）。虽然 digest() 可在流关闭前调用，但为保证语义清晰与资源确定性，推荐在 try 块末尾统一获取摘要值。
综上，通过 DigestInputStream，你能在一次数据搬运中无缝集成完整性校验，兼顾性能、健壮性与代码简洁性——这是 Java 安全 I/O 编程的经典范式之一。
