3、内核配置与编译：开启CONFIG_DEBUG_KMEMLEAK、配置扫描阈值、编译内核并验证kmemleak功能

要使用 kmemleak 进行内存泄漏检测，第一步是让内核支持该功能。这需要从源码配置阶段开始，正确开启相关编译选项，并根据实际场景调整扫描行为。本章将完整演示从内核配置、编译到功能验证的全流程。

3.1 内核配置：开启 kmemleak 核心选项

kmemleak 依赖于内核的 DEBUG_FS 和 STACKTRACE 支持。在 make menuconfig 或 make xconfig 界面中，需要依次定位并开启以下选项：

配置项 路径 说明 推荐值
CONFIG_DEBUG_KMEMLEAK Kernel hacking → Memory Debugging kmemleak 主开关，开启后内核会跟踪所有内存分配/释放 y
CONFIG_DEBUG_KMEMLEAK_EARLY_LOG_SIZE Kernel hacking → Memory Debugging 早期启动阶段日志缓冲区大小（条目数），默认 400 400 或 800
CONFIG_DEBUG_KMEMLEAK_DEFAULT_OFF Kernel hacking → Memory Debugging 默认关闭 kmemleak，需手动 echo scan > /sys/kernel/debug/kmemleak 开启 n（建议默认开启）
CONFIG_DEBUG_FS Kernel hacking 提供 /sys/kernel/debug 接口，kmemleak 通过此文件系统暴露控制节点 y
CONFIG_STACKTRACE General setup 支持栈回溯，kmemleak 报告需要栈信息定位泄漏点 y
配置建议： 如果内核用于生产环境，建议将 CONFIG_DEBUG_KMEMLEAK_DEFAULT_OFF 设为 n，让 kmemleak 默认开启；若担心性能开销，可设为 y，在需要时通过 echo scan > /sys/kernel/debug/kmemleak 动态激活。

以下是一个典型的 .config 片段，展示了 kmemleak 相关选项的正确状态：

# 内核内存泄漏检测
CONFIG_DEBUG_KMEMLEAK=y
CONFIG_DEBUG_KMEMLEAK_EARLY_LOG_SIZE=400
# CONFIG_DEBUG_KMEMLEAK_DEFAULT_OFF is not set

# 依赖项
CONFIG_DEBUG_FS=y
CONFIG_STACKTRACE=y

3.2 配置扫描阈值：控制检测灵敏度

kmemleak 的扫描行为可以通过内核参数或 /sys 接口动态调整。关键参数包括扫描间隔、最小泄漏大小和最大跟踪条目数。

参数 接口路径 默认值 说明
scan /sys/kernel/debug/kmemleak 手动触发 写入 scan 立即执行一次内存扫描
scan_interval /sys/kernel/debug/kmemleak 600 秒 自动扫描间隔，写入 scan_interval=300 可改为 5 分钟
min_leak_size /sys/kernel/debug/kmemleak 100 字节 小于此大小的潜在泄漏不报告，避免误报
max_track /sys/kernel/debug/kmemleak 10000 最多跟踪的分配条目数，超出后新分配不再记录
实战调优： 在嵌入式设备（内存 256MB 以下）上，建议将 max_track 降低至 2000，避免 kmemleak 自身占用过多内存；在服务器环境（内存 64GB 以上），可将 min_leak_size 提升至 1024 字节，过滤掉小对象噪声。

以下 SVG 图展示了 kmemleak 扫描阈值与报告生成的关系：

kmemleak 扫描阈值与报告生成流程 kmemleak 扫描阈值与报告生成流程 内存分配/释放 kmemleak 跟踪器 max_track 过滤 min_leak_size 过滤 扫描引擎 泄漏报告 说明：只有同时通过 max_track 和 min_leak_size 过滤的潜在泄漏才会进入扫描引擎，最终生成报告

3.3 编译内核：确保 kmemleak 模块正确构建

配置完成后，执行标准的内核编译流程。kmemleak 代码位于 mm/kmemleak.c，编译时会根据 CONFIG_DEBUG_KMEMLEAK 决定是否编译进内核映像。

# 清理旧构建
make clean

# 加载新配置
make olddefconfig

# 编译内核（使用多核加速）
make -j$(nproc)

# 编译模块
make modules -j$(nproc)

# 安装模块
make modules_install

# 安装内核
make install
注意： 如果内核版本较新（5.10+），kmemleak 默认内建（y），不会生成单独的 .ko 模块。若配置为 m，则需要确保 modprobe kmemleak 能正确加载。建议始终设为 y，避免模块加载顺序问题导致早期内存分配无法被跟踪。

3.4 验证 kmemleak 功能：启动与基本操作

使用新编译的内核启动系统后，通过以下步骤验证 kmemleak 是否正常工作：

  1. 检查 debugfs 挂载： 确认 /sys/kernel/debug 目录存在且可访问。
  2. 检查 kmemleak 节点： 查看 /sys/kernel/debug/kmemleak 文件是否存在。
  3. 触发手动扫描： 写入 scan 触发一次完整扫描。
  4. 读取报告： 读取 /sys/kernel/debug/kmemleak 查看潜在泄漏。
  5. 清除状态： 写入 clear 清除当前跟踪记录，开始新一轮检测。
# 1. 挂载 debugfs（如果未自动挂载）
mount -t debugfs none /sys/kernel/debug

# 2. 检查 kmemleak 节点
ls -l /sys/kernel/debug/kmemleak

# 3. 触发手动扫描
echo scan > /sys/kernel/debug/kmemleak

# 4. 读取泄漏报告
cat /sys/kernel/debug/kmemleak

# 5. 清除当前跟踪（开始新一轮检测）
echo clear > /sys/kernel/debug/kmemleak

以下 SVG 图展示了 kmemleak 验证的完整操作流程：

kmemleak 功能验证操作流程 kmemleak 功能验证操作流程 1. 挂载 debugfs 2. 检查节点 3. 触发扫描 4. 读取报告 5. 清除状态 验证成功标志 • 读取报告时无错误输出，或输出格式为 "unreferenced object ..." 的泄漏条目 • 写入 clear 后再次读取，报告内容被清空

3.5 常见问题与排查

现象 可能原因 解决方案
/sys/kernel/debug/kmemleak 不存在 debugfs 未挂载，或内核未开启 CONFIG_DEBUG_FS 执行 mount -t debugfs none /sys/kernel/debug；检查内核配置
读取 kmemleak 返回空 kmemleak 默认关闭（CONFIG_DEBUG_KMEMLEAK_DEFAULT_OFF=y） 写入 echo scan > /sys/kernel/debug/kmemleak 激活
报告显示大量误报 min_leak_size 设置过小，或扫描间隔太短 增大 min_leak_size（如 256 字节）；延长 scan_interval
系统启动变慢 kmemleak 早期扫描占用 CPU 设置 kmemleak=off 内核启动参数，运行时再手动开启
验证总结： 完成内核配置与编译后，务必在目标硬件上执行完整的验证流程。一个可正常工作的 kmemleak 环境，应当能够通过 cat /sys/kernel/debug/kmemleak 输出格式化的泄漏报告，并且支持 scan、clear、stack 等控制命令。这是后续章节进行实战案例分析的基础。
← 上一章 📖 返回目录 下一章 →