BPF程序加载成功但无法查找程序/映射：如何调试？

针对你遇到的bpf_object__open_file/bpf_object__load成功，但bpf_object__find_program_by_name/bpf_object__find_map_fd_by_name失败的问题，按以下步骤排查：

1. 先确认BPF ELF目标文件的有效性 #

这是最常见的根源：如果BPF程序编译出来的ELF没有正确的section，libbpf根本无法识别程序或映射。

• 用llvm-objdump -h <your_bpf_prog.o>查看ELF段，检查是否存在对应程序的section（比如tracepoint/sched/sched_switch、kprobe/do_sys_open这类以SEC宏定义命名的段），以及maps段。如果这些段缺失，说明BPF程序编译时没生成正确的section，比如漏写SEC()宏、LLVM编译选项错误。
• 用bpftool gen object dump <your_bpf_prog.o>解析BPF对象，直接查看里面的程序名称、映射名称是否和用户态代码中查找的完全一致（注意大小写敏感）。

2. 清理编译环境，排查编译环节问题 #

你提到全新机器编译后出现环境“污染”，换回原代码也无法运行，大概率是编译缓存或链接问题：

• 彻底清理编译缓存：执行make distclean（或手动删除build目录、.o文件、可执行文件），重新编译libbpf和你的BPF程序，避免旧目标文件残留。
• 检查BPF程序的编译选项：确保编译BPF代码时添加了-target bpf和-O2（或至少-O1，否则可能生成内核不支持的指令），且链接用户态程序时使用了正确的libbpf库（静态链接-lbpf-static或动态链接对应版本的libbpf.so）。
• 验证SEC宏的正确性：程序必须放在对应类型的SEC段中（如kprobe用SEC("kprobe/xxx")，tracepoint用SEC("tracepoint/xxx/xxx")），映射必须放在SEC("maps")段中，且名称要和用户态查找的完全匹配。

3. 检查libbpf加载逻辑与日志 #

即使bpf_object__load返回成功，也可能存在程序/映射加载被内核静默跳过的情况，需要开启libbpf调试日志排查：

• 在用户态代码中添加libbpf调试选项：

  LIBBPF_OPTS(bpf_object_open_opts, open_opts,
      .log_level = LIBBPF_DEBUG, // 开启最高级调试日志
  );
  struct bpf_object *obj = bpf_object__open_file("your_bpf_prog.o", &open_opts);
  

  运行程序时会输出详细的加载日志，查看是否有程序/映射加载失败的提示（比如内核不支持的BPF指令、权限不足、map定义不符合内核要求等）。
• 确认查找时机：bpf_object__find_program_by_name可以在bpf_object__open_file之后立即调用（不需要等到load），如果此时就找不到，说明libbpf根本没解析到该程序；如果load之后找不到map，可能是map加载失败但libbpf没报错（部分情况下load会跳过失败的map）。

4. 排查系统环境与缓存问题 #

• 清理BPF系统缓存：执行bpftool prog list和bpftool map list查看是否有旧的BPF程序/映射残留，用bpftool prog delete id <prog_id>和bpftool map delete id <map_id>删除，或者直接重启机器清空所有BPF资源。
• 检查libbpf版本兼容性：用ldd <your_user_program>查看用户态程序链接的libbpf库路径，确认是否为你编译的版本，避免系统自带的旧版libbpf（比如Ubuntu 20.04默认的libbpf可能版本较低，不支持某些新特性）。

5. 深度调试技巧 #

• 用gdb跟踪bpf_object__open_file的执行过程，查看libbpf的bpf_object__parse_elf函数是否正确解析了ELF的section，并将程序/映射添加到bpf_object的programs或maps链表中。如果链表为空，说明ELF解析失败，问题出在BPF目标文件本身。
• 对比正常运行的示例代码的编译输出：在全新机器上编译能正常运行的示例，复制其编译命令，对比你自己的编译命令，看是否有差异（比如CFLAGS、LDFLAGS、LLVM版本）。

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