Python中使用mmap时offset参数必须为内存分配粒度的整数倍-Python教程

使用python的`mmap`模块时，若传入的`offset`参数不是系统内存分配粒度（`mmap.allocationgranularity`）的整数倍，或超出文件实际大小，将触发`oserror: [errno 22] invalid argument`错误。

mmap并非任意偏移均可映射——它底层依赖操作系统的内存映射机制，而操作系统要求映射起始地址（即offset）必须对齐到特定边界，该边界由mmap.ALLOCATIONGRANULARITY定义（在大多数现代Linux/macOS系统上为4096字节，Windows通常也为4096，但可能因架构略有差异）。即使文件本身支持字节级寻址，mmap的offset也必须是该粒度的整数倍；否则内核直接拒绝映射请求，抛出“Invalid argument”。

此外，offset还须满足：offset + length ≤ 文件大小（当length=0时，表示映射从offset到文件末尾，因此要求offset ≤ 文件大小）。若offset越界，同样会报错。

✅ 正确用法示例：

import mmap
import os
import sys

if len(sys.argv) != 3:
    print("Usage: python script.py  ")
    sys.exit(1)

filepath = sys.argv[1]
offset = int(sys.argv[2])

# 获取文件大小与对齐粒度
with open(filepath, 'rb') as f:
    file_size = os.fstat(f.fileno()).st_size
    granularity = mmap.ALLOCATIONGRANULARITY

# 校验 offset 对齐性与范围
if offset % granularity != 0:
    raise ValueError(f"offset {offset} is not a multiple of ALLOCATIONGRANULARITY ({granularity})")

if offset > file_size:
    raise ValueError(f"offset {offset} exceeds file size {file_size}")

# 安全打开并映射
with open(filepath, 'rb') as f:
    mm = mmap.mmap(f.fileno(), length=0, access=mmap.ACCESS_READ, offset=offset)
    print(f"Successfully mapped {len(mm)} bytes starting at offset {offset}")
    # 示例：读取前16字节
    print("First 16 bytes:", mm[:16].hex() if len(mm) >= 16 else mm[:].hex())

⚠️ 注意事项：