SPDK项目共享库构建失败问题分析与解决方案

问题背景

在SPDK开源存储性能开发工具包项目中，开发人员发现当使用--with-shared选项启用共享库构建时，如果采用单线程编译（即不使用-j参数），构建过程会失败。这一问题在SPDK的主分支和v24.05版本中均能复现。

错误现象

构建过程中会在编译event_bdev模块时出现错误，具体表现为编译器无法找到libspdk_event_keyring.so文件。错误信息如下：

c++: error: /path/to/spdk/build/lib/libspdk_event_keyring.so: No such file or directory

问题分析

经过深入调查，发现问题的根源在于构建系统的依赖关系定义不完整。在module/event/subsystems/Makefile文件中，bdev模块的依赖项DEPDIRS-bdev中缺少了对keyring模块的依赖声明。

这种依赖缺失导致构建系统在单线程编译时，会尝试在keyring模块尚未构建完成的情况下就开始构建依赖它的bdev模块，从而引发文件找不到的错误。

技术原理

在SPDK的构建系统中，模块间的依赖关系通过Makefile中的DEPDIRS变量显式声明。当使用多线程编译时，由于并发执行的随机性，有时会"碰巧"先构建了依赖模块，掩盖了依赖关系定义不完整的问题。而在单线程顺序执行时，这种依赖缺失就会暴露出来。

解决方案

修复方案非常简单，只需在module/event/subsystems/Makefile文件中，为bdev模块的DEPDIRS添加keyring依赖：

DEPDIRS-bdev := accel vmd sock iobuf keyring

这一修改确保了构建系统能正确理解模块间的依赖关系，保证keyring模块会在bdev模块之前被构建。

验证结果

应用此修复后：

1. 单线程构建(make)能够顺利完成
2. 多线程构建(make -jN)行为保持不变
3. 共享库功能正常工作

经验总结

这个问题给我们提供了几个重要的经验教训：

1. 依赖关系完整性：在模块化系统中，必须明确定义所有依赖关系，即使某些情况下看似能正常工作。

2. 构建测试：除了多线程构建测试外，单线程构建测试同样重要，可以暴露依赖关系问题。

3. 构建系统设计：良好的构建系统应该能够自动检测并报告未满足的依赖关系，而不是依赖并发执行的随机性。

对于SPDK开发者而言，这个案例也提醒我们需要定期审查模块间的依赖关系，确保构建系统的健壮性。