错误做法是用 bufferedoutputstream 包裹 cipheroutputstream，因其会破坏加密完整性；正确方式是将 bufferedoutputstream 作为 cipheroutputstream 的底层节点流，先写入 iv 再加密，且必须调用 close() 触发 dofinal()。
直接用 BufferedOutputStream 包裹 CipherOutputStream 是错误做法，会破坏加密流的完整性校验和块处理逻辑。
CipherOutputStream 本身已内置缓冲机制，且必须按密码学语义逐块写入、严格对齐。外层再套 BufferedOutputStream 会导致：
- 缓冲区延迟 flush，使最后一块未及时写出，解密时缺字节报错
- 可能截断 GCM 的认证标签（如 AES/GCM 模式下最后16字节是 MAC）
- 在 CBC 等模式中破坏填充结构（如 PKCS5Padding），导致解密失败
✅ 正确组合方式是：CipherOutputStream 作为最外层输出流，内部直接对接 FileOutputStream（或带缓冲的 FileOutputStream）
✅ 推荐写法：用 BufferedOutputStream 作为 CipherOutputStream 的底层节点流
FileOutputStream fos = new FileOutputStream(outputFile); BufferedOutputStream bos = new BufferedOutputStream(fos); // 提升磁盘写入效率 CipherOutputStream cos = new CipherOutputStream(bos, cipher); // 加密逻辑在此注入 // 写入明文，cos 自动加密并经 bos 缓冲后落盘 IOUtils.copy(is, cos); // 或循环 read/write cos.close(); // 必须 close，触发 doFinal() 补全最后一块
这样既保留了 CipherOutputStream 对密码操作的精确控制（自动处理 padding、GCM tag、doFinal），又通过 BufferedOutputStream 减少了系统调用次数，提升大文件写入吞吐量。
✅ 关键注意事项
- 不要跳过 close()：CipherOutputStream 的 close() 会调用 cipher.doFinal()，补全最后一块（含 padding 或 GCM tag）。若只 flush() 不 close，密文不完整，解密必失败
- IV 必须前置写入：先用普通 FileOutputStream（或 BufferedOutputStream）把 IV（如 16 字节）写入目标文件开头，再构造 CipherOutputStream 写密文
- 避免手动分块调用 write(byte[], off, len)：除非你精确控制块大小（如 AES 恰好 16 字节对齐），否则交给 CipherOutputStream 自动处理更安全
-
GCM 模式需额外注意：使用
AES/GCM/NoPadding时，务必指定 GCMParameterSpec（如new GCMParameterSpec(128, iv)），且密文末尾的 16 字节认证标签不可丢弃
✅ 实际代码片段（AES/GCM 加密大文件）
// 1. 生成随机 IV
byte[] iv = new byte[12]; // GCM 推荐 12 字节 IV
new SecureRandom().nextBytes(iv);
// 2. 写 IV 到文件开头
try (FileOutputStream fos = new FileOutputStream(outputFile);
BufferedOutputStream bos = new BufferedOutputStream(fos)) {
bos.write(iv); // 先写 IV
// 3. 构建加密流（基于剩余位置）
Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
cipher.init(Cipher.ENCRYPT_MODE, secretKey, new GCMParameterSpec(128, iv));
CipherOutputStream cos = new CipherOutputStream(bos, cipher);
// 4. 流式加密（自动缓冲 + 密码处理）
IOUtils.copy(inputStream, cos); // Apache Commons IO
// 或手动：
// byte[] buf = new byte[8192];
// int n;
// while ((n = inputStream.read(buf)) != -1) {
// cos.write(buf, 0, n);
// }
cos.close(); // 关键！触发 doFinal()
}
不复杂但容易忽略：IV 要存、close 要调、BufferedOutputStream 放底层、别包 CipherOutputStream。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
