GRUB Multiboot2未返回正确信息，自制OS黑屏求助

关键现象复盘 #

• QEMU窗口尺寸变化、光标消失，说明GRUB可能已切换到图形模式，但内核未正确获取/使用帧缓冲信息
• 串口调试显示Multiboot信息的flags为0，未置位MULTIBOOT_INFO_FRAMEBUFFER_INFO（0x1000），确认GRUB未提供帧缓冲相关数据

核心排查步骤 #

1. 检查Multiboot2头部的帧缓冲请求Tag #

GRUB仅会在内核显式请求时才提供帧缓冲信息，需确保你的header.asm中包含正确的帧缓冲请求Tag：

; 示例帧缓冲请求Tag（可根据需求调整参数）
framebuffer_tag:
    dw MULTIBOOT_TAG_TYPE_FRAMEBUFFER
    dw 0 ; 无标志位
    dd framebuffer_tag_end - framebuffer_tag ; Tag总长度
    dd 1920 ; 宽度（设为0则由GRUB自动选择）
    dd 1080 ; 高度（设为0则由GRUB自动选择）
    dd 32 ; 颜色深度（设为0则由GRUB自动选择）
framebuffer_tag_end:

同时必须确保头部校验和计算正确，错误的校验和会导致GRUB忽略所有自定义Tag。

2. 验证Multiboot2头部的合法性 #

确认头部完全符合规范要求：

• 魔数必须为0xE85250D6（32位）
• 架构字段需设为0（对应i386架构）
• 头部总长度需正确计算，包含所有Tag的长度
• 校验和需满足：魔数 + 架构 + 长度 + 校验和 = 0 mod 2^32

3. 检查GRUB配置中的内核引导参数 #

确保GRUB配置未禁用帧缓冲功能，示例正确配置如下：

menuentry "My OS" {
    multiboot2 /boot/kernel.bin
    boot
}

避免添加vga=normal等强制文本模式的参数。

4. 确认Multiboot信息结构体的读取逻辑 #

在entry.c中，检查读取Multiboot2信息结构体的代码是否正确：

• 确保从GRUB传递的寄存器（x86架构下为ebx）中正确获取信息结构体地址
• 遍历Tag时，严格遵循8字节对齐规则处理Tag偏移
• 打印flags时，确认读取的是Multiboot信息结构体中的对应字段，而非未初始化变量

5. 内核侧帧缓冲初始化验证 #

即使GRUB提供了帧缓冲信息，也需验证内核初始化逻辑：

• 直接向帧缓冲起始地址写入测试像素（比如写入0xFFFFFF即白色像素）
• 检查颜色深度是否与请求值一致，避免因格式不匹配导致显示异常

补充建议 #

如果上述步骤仍未解决问题，可以：

• 替换为最新版本的GRUB，确保对Multiboot2的支持完善
• 简化内核代码，仅保留Multiboot信息读取和帧缓冲测试逻辑，排除其他代码干扰

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