mmap返回map_failed的常见原因主要是enomem（内存不足）和eacces（权限不足），如/dev/shm空间不足、shm_open未用o_rdwr、文件权限不匹配、映射长度非页对齐或为0。
共享内存映射失败：mmap 返回 MAP_FAILED 的常见原因
多数人卡在第一步——连共享内存都映射不上，mmap 直接返回 MAP_FAILED，errno 常见为 ENOMEM 或 EACCES。这不是代码写错了，而是系统资源或权限没配对。
实操建议：
-
/dev/shm默认大小通常只有 64MB（CentOS/RHEL），大数据传输前必须扩容：sudo mount -o remount,size=2G /dev/shm - 用
shm_open创建时，第二个参数必须含O_RDWR，且第三个参数需设明确权限（如0666），否则后续mmap会因无读写权限失败 - 父子进程间直接继承 fd 可省去
shm_open重开步骤；跨无关进程则必须用相同 name（如"/mydata"）且确保 name 以/开头、不含路径分隔符 - 映射长度不能为 0，且需是页对齐的——若数据大小非
getpagesize()整数倍，务必向上取整，否则mmap拒绝
同步机制选型：为什么不用 sem_wait 而用 pthread_mutex_t + pthread_cond_t 放在共享内存里
共享内存本身不带同步能力。很多人第一反应是“加个命名信号量”，但 sem_open 创建的信号量默认不在共享内存中，且跨进程销毁易残留。更稳的方式是把 pthread 同步原语直接建在共享内存里。
实操建议：
-
pthread_mutexattr_setpshared(&attr, PTHREAD_PROCESS_SHARED)和pthread_condattr_setpshared(&cattr, PTHREAD_PROCESS_SHARED)必须调用，否则只对本进程有效 - mutex/cond 初始化必须在首次创建共享内存的进程中完成，且要检查
pthread_mutex_init返回值——它可能因内存未初始化而失败 - 避免死锁：生产者写完数据后先
pthread_mutex_lock→memcpy→pthread_cond_signal→pthread_mutex_unlock；消费者严格按反序等待，不跳步 - 别用
usleep轮询代替条件变量，1GB 数据传一次轮询几万次，CPU 白耗
大块数据零拷贝传输：如何让 sender 不复制、receiver 不重复解析
共享内存本质是“一块大家都能读写的物理内存”，但直接裸传结构体或 vector 指针会崩溃——因为指针地址在各进程虚拟空间中不一致。必须做内存布局约定。
实操建议：
- 所有数据结构必须是 POD（Plain Old Data）类型：禁用
std::string、std::vector、虚函数、非 trivial 构造/析构 - 用固定偏移+长度描述数据区，例如共享内存头部放一个
struct Header { uint64_t magic; uint64_t data_offset; uint64_t data_size; };，后续数据紧贴其后 - sender 写入时，先填 header，再用
memcpy把原始 buffer（如uint8_t*）拷到(char*)addr + header.data_offset，不 new 不 malloc - receiver 读取时，仅解析 header 获取 offset/size，然后直接 cast 成所需结构体指针（前提是结构体定义完全一致、打包对齐相同）
进程异常退出导致共享内存残留：清理策略必须前置设计
程序 crash 或 kill -9 后，shm_unlink 不会被执行，/dev/shm/mydata 文件长期存在，下次启动又 open 失败——这是线上最常被忽略的运维坑。
实操建议：
- 启动时先尝试
shm_open(..., O_CREAT | O_EXCL ...)，失败且errno == EEXIST，说明上次没 clean，立刻shm_unlink再重试 - 不要依赖 atexit() —— 它对 SIGKILL 无效；可用
signal(SIGINT, cleanup_handler)+signal(SIGTERM, cleanup_handler)覆盖常规退出路径 - 更鲁棒的做法：用文件锁（
flock）在/tmp/mydata.lock上做互斥，成功加锁才进入共享内存流程，进程退出自动释放锁 - 调试阶段务必加日志：每次
shm_open、mmap、shm_unlink都打印 pid 和返回值，否则残留问题根本无法复现定位
真正麻烦的不是映射或同步逻辑，而是当 sender 和 receiver 进程生命周期不对齐、或部署在不同用户下运行时，权限、umask、挂载选项三者稍有不一致，mmap 就静默失败——这种问题不会报错，只会让数据永远停在内存外。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
