Rust中mmap报错处理：SIGBUS及字符设备映射失败问题

数据老陈

2026-8-16

问题解决方法

常规文件mmap触发SIGBUS错误的解决

SIGBUS错误的核心原因是映射的内存区域超出了文件实际大小。mmap仅建立虚拟内存与文件的映射关系，当访问文件不存在的偏移位置时，内核无法读取对应数据，就会触发该错误。

解决步骤：

确保映射长度不超过文件实际大小，可先获取文件大小再映射：

use std::fs::File;

let file = File::open("target_file").unwrap();
let file_size = file.metadata().unwrap().len() as usize;
let mut mmap_var = memmap::MmapOptions::new()
    .len(file_size)
    .map_mut(&file)
    .unwrap();

若需映射比原文件大的区域，需先扩展文件至目标长度：

use std::fs::OpenOptions;

let mut file = OpenOptions::new()
    .read(true)
    .write(true)
    .open("target_file")
    .unwrap();
// 扩展文件到8G大小
file.set_len(8589934592).unwrap();
let mut mmap_var = memmap::MmapOptions::new()
    .len(8589934592)
    .map_mut(&file)
    .unwrap();

字符设备mmap出现"No such device"错误的解决

错误码19对应ENODEV，本质是目标字符设备不支持mmap操作。字符设备是否支持mmap由其驱动程序决定，像/dev/null、/dev/random这类通用字符设备通常无mmap能力，因为没有可映射的固定存储区域。

解决方法：

确认目标设备是否支持mmap：查阅设备驱动文档或硬件说明，仅部分自定义字符设备、硬件类设备（如GPU显存、特定串口驱动）支持mmap。

改用read/write接口交互：对于不支持mmap的设备，直接用标准IO接口操作：

use std::fs::File;
use std::io::{Read, Write};

let mut file = File::open("/dev/target_char_dev").unwrap();
let mut buf = [0u8; 65000];
// 读取设备数据
file.read(&mut buf).unwrap();
// 写入数据到设备
file.write(&buf).unwrap();