Solaris下Apex C++使用fread报总线错误、缓冲模式读数据异常

全缓冲模式读取数据错误 #

核心错误是将fread的目标数据缓冲区和setvbuf绑定给文件流的缓冲区设为了同一块内存bf。
_IOFBF全缓冲模式下，fread的执行逻辑为：先从磁盘读取数据填充到文件流绑定的内部缓冲区，再从流缓冲区拷贝数据到用户传入的fread目标缓冲区。当两块缓冲区指向同一块内存时，拷贝过程会直接覆盖流缓冲区中尚未读取的有效数据，最终导致输出内容错乱。
_IONBF无缓冲模式下，stdio库不会使用绑定的bf作为流缓存，每次fread直接发起系统调用将磁盘数据读入目标缓冲区，不存在内存覆盖问题，因此数据正确；但无缓冲模式每读一次数据都会触发用户态/内核态切换，跳过了用户态缓存的批量读优化，运行耗时会远高于全缓冲模式。

总线错误（bus error）触发原因 #

Solaris多运行于SPARC架构，该架构对内存对齐有强制要求，未对齐的内存访问会直接触发总线错误：

• 手动传入setvbuf/setbuf的缓冲区bf如果没有满足stdio库要求的对齐规则（SPARC架构下通常要求缓冲区起始地址至少8字节对齐，部分stdio实现要求16字节对齐），库内做批量内存拷贝、指针偏移操作时就会触发未对齐访问报错。
• setbuf是老旧的无返回值接口，不会做参数合法性校验，传入非法指针、未对齐缓冲区时不会提前报错，只会在后续IO操作中触发崩溃。
• 不手动指定缓冲区时如果仍触发总线错误，需排查两个问题：一是setvbuf调用时机不对（C标准要求setvbuf必须在fopen成功后、任何流读写操作之前调用，中间如果有隐式的流访问会触发未定义行为）；二是代码中存在文件句柄大小写笔误——示例代码中fopen返回的句柄是小写fh，fread传入的是大写FH，属于未初始化变量访问，也会触发随机崩溃。

• 拆分缓冲区：绝对不要将流绑定缓冲区和IO读写的数据缓冲区共用同一块内存，两类缓冲区必须独立分配。
• 保证缓冲区对齐：手动提供流缓冲区时，必须保证起始地址满足平台对齐要求；如果不想手动管理对齐，直接给setvbuf传NULL作为缓冲区参数，让stdio库自行分配、管理对齐合规的缓冲区。
• 替换老旧接口：全部废弃setbuf调用，统一使用setvbuf，每次调用后检查返回值，非0代表设置失败，需做错误处理。
• 修正调用时机：setvbuf必须紧跟在fopen成功返回之后调用，中间不要插入任何针对该文件句柄的操作。
• 修正笔误：统一文件句柄变量名大小写，避免访问未初始化内存。

参考修复代码：

#include <stdio.h>
#include <stdint.h>
#define KB64 (64*1024)

// 流专用缓冲区，强制16字节对齐适配SPARC架构要求
static char stream_buf[KB64] __attribute__((aligned(16)));
// IO读数据专用缓冲区，和流缓冲区完全独立
char data_buf[KB64];

int read_file(const char *fname) {
    FILE *fh = fopen(fname, "rb");
    if (!fh) return -1;

    // 紧跟fopen之后设置全缓冲，传入独立的流缓冲区
    if (setvbuf(fh, stream_buf, _IOFBF, sizeof(stream_buf)) != 0) {
        fclose(fh);
        return -1;
    }

    // fread传入独立的数据缓冲区，句柄变量名和fopen返回值一致
    int n = fread(data_buf, 1, sizeof(data_buf), fh);

    /* DISPLAY first 50 characters */

    fclose(fh);
    return n;
}

如果不需要自定义缓冲区大小，直接去掉setvbuf调用即可，系统默认的全缓冲配置由stdio库自行管理缓冲区的分配、对齐和释放，不会出现对齐类总线错误，性能也能达到最优。

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