Java中MappedByteBuffer通过FileChannel.map()实现内存映射，绕过内核缓冲区拷贝以提升大文件性能；需区分READ_ONLY、READ_WRITE、PRIVATE三种模式，注意2GB单次映射限制、本地内存占用及无显式unmap机制。
Java中使用MappedByteBuffer实现内存映射，本质是通过FileChannel.map()将文件直接映射到进程的虚拟内存空间，绕过传统IO的内核缓冲区拷贝，提升大文件读写性能。关键在于理解映射模式、容量限制和资源管理。
一、三种映射模式的区别与选择
READ_ONLY：只读映射，适合加载配置、资源文件等不需修改的场景；
READ_WRITE：读写映射，修改会同步到文件（但不保证立即刷盘，依赖操作系统）；
PRIVATE：写时复制（copy-on-write），修改仅影响内存副本，不影响原文件——注意Java不直接暴露该模式常量，需用StandardOpenOption.PRIVATE配合（JDK 12+），旧版本通常不推荐手动使用。
二、基本使用步骤（以读写映射为例）
需确保文件存在且有对应权限，推荐使用try-with-resources管理通道：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 用
RandomAccessFile或Files.newByteChannel()打开文件通道 - 调用
channel.map(mode, position, size)获取MappedByteBuffer - 像操作普通ByteBuffer一样读写：如
putInt(123)、getInt()、put(byteArray) - 写入后如需强制落盘，可调用
buffer.force()（仅对READ_WRITE有效）
三、必须注意的限制与陷阱
单次映射最大约2GB（Integer.MAX_VALUE），超大文件需分段映射；
映射区域不能动态扩容，size在map时就固定；MappedByteBuffer不受JVM堆内存控制，其占用属于本地内存（Native Memory），GC不回收——频繁映射大文件可能引发OutOfMemoryError: Map failed；
映射文件被外部删除或截断，可能导致IOException或静默数据损坏，生产环境建议加锁或监控文件状态。
四、释放映射的正确方式
Java没有提供显式“unmap”API，JVM仅在MappedByteBuffer被GC回收后由底层清理映射。但GC时机不可控，长期运行服务易内存泄漏：
- 避免长期持有大块MappedByteBuffer引用
- 用完及时置为null，配合System.gc()（仅提示，不保证）
- JDK 9+ 可借助
Cleaner机制，在对象不可达时触发清理（需反射调用sun.misc.Cleaner或使用java.lang.ref.Cleaner） - 更稳妥做法：控制映射粒度，用完尽快关闭关联的FileChannel
基本上就这些。内存映射不是万能加速器，适合随机访问、频繁读写的大文件场景；小文件或顺序读写，传统IO反而更简单稳定。
立即学习“Java免费学习笔记（深入）”；
