mmap异常通常由参数误用、资源限制、内存布局冲突或内核配置引起，需检查返回值与errno、/proc/pid/maps布局、文件约束及系统限制（如max_map_count、overcommit_memory）。
Linux中mmap调用失败或映射行为异常（如访问段错误、数据不一致、权限不符、地址冲突等），通常不是随机发生，而是由参数误用、资源限制、内存布局冲突或内核配置引起。排查需从调用上下文、系统状态和内核日志三方面入手。
检查mmap返回值与errno
mmap失败时返回MAP_FAILED（即(void *)-1），必须立即检查errno，这是最直接的线索：
-
ENOMEM：常见但含义多样——可能是虚拟地址空间不足（32位进程易触发）、RLIMIT_AS/RLIMIT_DATA超限、或系统整体内存+swap耗尽； -
EACCES：文件映射时权限不足（如O_RDONLY文件却用PROT_WRITE）；或尝试MAP_PRIVATE+PROT_WRITE映射只读设备（如某些proc/sysfs节点）； -
EINVAL：参数非法——offset非页对齐、len为0、addr非NULL但未按页对齐且未设MAP_FIXED、flags与prot冲突（如MAP_SHARED+PROT_WRITE映射不可写文件）； -
EBADF：传入了无效fd（已关闭、非映射支持类型，如普通管道fd）； -
EPERM：尝试MAP_LOCKED但无CAP_IPC_LOCK能力，或内核禁用大页锁定。
确认虚拟内存布局与地址冲突
使用/proc/PID/maps观察进程当前映射区域，重点排查：
- 是否在指定
addr处已有其他映射（尤其是设置了MAP_FIXED却未先munmap）； - 是否存在大量匿名映射碎片，导致大块连续地址无法分配（
cat /proc/PID/status | grep VmPeak看峰值虚拟内存）； - 32位进程注意用户空间上限（通常3GB），
brk堆顶与栈底接近时，mmap可能因找不到足够间隙而失败。
调试技巧：临时去掉MAP_FIXED，让内核自主选址；或用strace -e trace=mmap,munmap捕获实际调用参数与返回值。
验证文件映射相关约束
对文件映射（fd != -1），需额外检查：
- 文件是否被截断或删除：映射后原文件被
truncate()或unlink()，不会立即影响映射，但后续msync(MS_SYNC)可能失败，读写行为依映射类型而异； - 文件系统是否支持mmap：某些网络文件系统（NFSv3早期版本）、tmpfs特殊挂载选项下可能拒绝写时复制（COW）；
- 偏移量
offset必须是页对齐（getpagesize()），否则EINVAL； -
MAP_SHARED映射修改后需msync确保落盘，否则依赖文件系统策略，可能丢失。
关注系统级限制与内核配置
运行时限制和内核参数直接影响mmap行为：
- 检查
ulimit -v（RLIMIT_AS）、ulimit -d（RLIMIT_DATA），过严会直接触发ENOMEM； -
/proc/sys/vm/max_map_count：单进程最大mmap区域数，默认65530，映射过多小区域（如每个共享库一个）可能触顶，报ENOMEM； -
/proc/sys/vm/overcommit_memory：设为2时严格检查可用内存+swap，物理内存紧张时mmap更易失败； - dmesg中搜索"mmap"或"out of memory"，确认是否触发OOM killer或内核拒绝分配。
不复杂但容易忽略
