动态模块加载失败需逐层排查：先查控制台debug日志中的errno及路径拼写，再验文件存在性、权限与abi兼容性，接着检查ld_library_path下的依赖库完整性，最后确认导出符号、abi版本及c++符号修饰。
嵌入式系统中，Master 进程（如 DonauKit 的 batch-master、FreeMASTER 主控服务或自定义主控守护进程）常负责动态加载外设驱动、算法模块或业务插件。当出现“动态模块加载失败”时，仅看报错信息（如 Cannot load module 或 dlopen failed: file not found）往往掩盖了真实原因。关键不是直接改代码，而是利用 Master 进程控制台输出+配套工具，逐层验证加载链路。
查看 Master 控制台原始日志输出
启动 Master 时务必启用完整日志级别（如 --log-level=DEBUG 或配置 log_level: debug），避免默认的 INFO 级别过滤掉关键线索：
- 关注含
dlopen、load_module、so、.elf、algorithm的行，尤其注意其后紧跟的 errno 编号（如errno=2表示 No such file，errno=12表示 Cannot allocate memory）； - 检查模块路径是否被拼接错误——例如控制台显示
trying to load /opt/modules//sensor_v2.so（双斜杠），说明配置里多写了末尾/； - 留意时间戳是否异常跳变，可能表明模块加载被阻塞在某个初始化函数中（如硬件等待超时）。
确认模块文件存在性与权限
Master 进程以特定用户身份运行（如 donau_guest 或 root），其文件系统视角与当前 shell 不同：
- 用
systemctl status batch-master查看实际运行用户和工作目录（WorkingDirectory=）； - 切换到该用户执行：
sudo -u donau_guest ls -l /opt/modules/sensor_v2.so，确认文件可读、非零大小、无 SELinux 标签拦截（ls -Z）； - 对 ARM 架构模块，额外检查 ABI 兼容性：
file /opt/modules/sensor_v2.so应显示ARM aarch64，而非x86_64。
验证模块依赖完整性
动态模块自身可能依赖其他共享库（如 libhal.so、libcrypt.so.1），而 Master 进程的 LD_LIBRARY_PATH 可能未包含这些路径：
- 用
readelf -d /opt/modules/sensor_v2.so | grep NEEDED列出所有依赖库名； - 在 Master 进程上下文中检查是否可解析：
sudo -u donau_guest /bin/sh -c 'LD_LIBRARY_PATH=/opt/lib:$LD_LIBRARY_PATH ldd /opt/modules/sensor_v2.so'； - 若提示
not found，需将对应路径加入 Master 的启动环境（如修改 systemd service 文件中的Environment=LD_LIBRARY_PATH=...）。
检查模块符号与接口兼容性
即使模块成功 dlopen，若缺少必需符号（如 init_module、deinit_module 函数），Master 会拒绝启用：
- 用
nm -D /opt/modules/sensor_v2.so | grep init_module确认导出符号存在且非UND（undefined）； - 比对模块 ABI 版本：Master 通常要求模块提供
MODULE_ABI_VERSION宏或版本字符串，控制台日志中若有ABI mismatch: expected 2, got 1即需重新编译模块； - 若模块使用 C++ 编写，注意符号修饰（mangling）问题——确保导出函数用
extern "C"声明，否则 Master 找不到纯 C 接口。
