mmap仅支持小文件？映射近100kB文件时内存与文件内容不符

这种映射后内容错位的问题我之前帮同事排查过几次，咱们一步步拆解可能的原因：

1. 映射参数的低级错误（最常见！） #

mmap的offset参数必须是系统页大小的整数倍（通常是4096字节），如果你传了非对齐的偏移值，内核会自动把它对齐到最近的页起始位置——这就会导致前几个字节碰巧对上，但后面的内容完全错位。

• 检查你的mmap调用：void *mmap(void *addr, size_t length, int prot, int flags, int fd, off_t offset);
• 确认offset是sysconf(_SC_PAGESIZE)的整数倍，或者直接传0（从文件开头映射）
• 同时核对length参数是否和实际文件大小一致，如果length比文件小，超出部分会是零页垃圾数据

2. 文件在映射前后被修改 #

如果在调用mmap之后，你的代码或者其他进程对原文件做了写入、截断操作，内存映射的内容会同步变化；但如果是映射前文件没写完就直接映射，也可能出现内容不一致。

• 检查映射前后有没有对文件描述符fd执行写操作
• 映射前用stat获取文件大小，映射后再对比一次，确认文件没被篡改

3. 缓存同步问题 #

虽然mmap直接关联页缓存，但如果打开文件时用了O_DIRECT绕开缓存，或者写入后没刷盘就映射，会出现内存和磁盘内容不一致的情况。

• 查看open调用的参数，有没有O_DIRECT？如果有，写文件后要调用fsync(fd)再映射
• 映射后可以调用msync(addr, length, MS_SYNC)强制同步，再对比内容

4. 调试器的显示误区 #

有时候不是内存内容错了，是调试器的显示出问题了！比如你是不是算错了查看的内存地址？或者调试器的十六进制显示格式设置错了（比如默认显示32位而非8位）？

• 写一段简单代码直接打印映射内存的内容，和文件的xxd输出对比，排除调试器的问题
• 确认调试器里查看的地址确实是mmap返回的起始地址，没有额外偏移

5. 特殊文件系统的坑 #

如果文件在NFS、tmpfs这类特殊文件系统上，可能存在缓存一致性问题；或者权限不足导致映射的是只读副本。

• 把文件复制到本地普通磁盘（比如ext4）再测试，看问题是否消失
• 检查mmap的prot和flags参数：要读取的话prot设PROT_READ，要同步修改用MAP_SHARED，私有映射用MAP_PRIVATE

快速验证代码 #

写个最小测试程序，排除其他代码干扰：

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <sys/mman.h>
#include <sys/stat.h>
#include <unistd.h>

int main() {
    int fd = open("your_file.bin", O_RDONLY);
    if (fd == -1) { perror("open"); return 1; }

    struct stat st;
    if (fstat(fd, &st) == -1) { perror("fstat"); return 1; }

    void *addr = mmap(NULL, st.st_size, PROT_READ, MAP_PRIVATE, fd, 0);
    if (addr == MAP_FAILED) { perror("mmap"); return 1; }

    // 读取文件到缓冲区对比
    char *buf = malloc(st.st_size);
    lseek(fd, 0, SEEK_SET);
    read(fd, buf, st.st_size);
    for (int i=0; i<st.st_size; i++) {
        if (((unsigned char*)addr)[i] != ((unsigned char*)buf)[i]) {
            printf("偏移%d不匹配: 内存=0x%02x, 文件=0x%02x\n", i, ((unsigned char*)addr)[i], ((unsigned char*)buf)[i]);
            break;
        }
    }

    munmap(addr, st.st_size);
    close(fd);
    free(buf);
    return 0;
}

编译运行后看输出，就能确认是真的内容不匹配，还是调试器的问题。

内容的提问来源于stack exchange，提问作者Mr B