HarmonyOS Next开发学习手册——Node-API常见问题

ArkTS/JS侧import xxx from libxxx.so后，使用xxx报错显示undefined/not callable或明确的Error message

1. 排查.cpp文件在注册模块时的模块名称与so的名称匹配一致。

如模块名为entry，则so的名字为libentry.so，napi_module中nm_modname字段应为entry，大小写与模块名保持一致。

2.排查so是否加载成功。

应用启动时过滤模块加载相关日志，重点搜索"dlopen"关键字，确认是否有相关报错信息；常见加载失败原因有权限不足、so文件不存在以及so已拉入黑名单等，可根据以下关键错误日志确认问题。其中，多线程场景(worker、taskpool等)下优先检查模块实现中nm_modname是否与模块名一致，区分大小写。

3.排查依赖的so是否加载成功。

确定所依赖的其它so是否打包到应用中以及是否有权限打开。常见加载失败原因有权限不足、so文件不存在等，可根据以下关键错误日志确认问题。

4.排查模块导入方式与so路径是否对应。

若JS侧导入模块的形式为： import xxx from ‘@ohos.yyy.zzz’，则该so将在/system/lib/module/yyy中找libzzz.z.so或libzzz_napi.z.so，若so不存在或名称无法对应，则报错日志中会出现dlopen相关日志。

注意，32位系统路径为/system/lib，64位系统路径为/system/lib64。

已知关键错误日志	修改建议
module $SO is not allowed to load in restricted runtime	$SO表示模块名。该模块不在受限worker线程的so加载白名单，不允许加载，建议用户删除该模块。
module $SO is in blocklist, loading prohibited	$SO表示模块名。受卡片或者Extension管控，该模块在黑名单内，不允许加载，建议用户删除该模块。
load module failed. $ERRMSG	动态库加载失败。$ERRMSG表示加载失败原因，一般常见原因是so文件不存在、依赖的so文件不存在或者符号未定义，需根据加载失败原因具体分析。
try to load abc file from $FILEPATH failed.	通常加载动态库和abc文件为二选一：如果是要加载动态库并且加载失败，该告警可以忽略；如果是要加载abc文件，则该错误打印的原因是abc文件不存在，$FILEPATH表示模块路径。

1.如果有明确的Error message，可以通过Error message判断当前问题。

Error message