HarmonyOS 鸿蒙Next中golang编译的so动态库调用异常,日志无输出
HarmonyOS 鸿蒙Next中golang编译的so动态库调用异常,日志无输出
golang 应用编译成 so 动态库供鸿蒙 native 调用
我有一个golang程序
package main
// #include <stdlib.h>
import "C"
import "fmt"
func main() {}
//export golang_add
func golang_add(a, b int) int {
fmt.Println("Adding", a, "and", b)
return a + b
}
想要构建到鸿蒙中使用,这一步我走了不少弯路,但是经过社区大佬指引已成功编译,方法就是使用 log-adaptor 修复构建安卓包报错问题
CC=${OHOS_LLVMBIN}/clang \
CXX=${OHOS_LLVMBIN}/clang++ \
GOOS=android GOARCH=amd64 CGO_ENABLED=1 \
go build -o libmyapp.so -buildmode=c-shared ./
通过 dlopen
测试可以拿到 fd,dlsym
能拿到函数。在此能说明这个 so 是能正常使用的。
接下来我把 so 文件放在 entry/libs/x86_64/
目录下,在 CMakeLists.txt
文件引入
set(PROJECT_ROOT_PATH ${NATIVERENDER_ROOT_PATH}../../../../)
target_link_libraries(entry PUBLIC ${PROJECT_ROOT_PATH}/libs/${OHOS_ARCH}/libmyapp.so)
napi_init.cpp
文件
#include "napi/native_api.h"
#include "include/libmyapp.h"
#include "hilog/log.h"
static napi_value Add(napi_env env, napi_callback_info info)
{
size_t argc = 2;
napi_value args[2] = {nullptr};
napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
napi_valuetype valuetype0;
napi_typeof(env, args[0], &valuetype0);
napi_valuetype valuetype1;
napi_typeof(env, args[1], &valuetype1);
double value0;
napi_get_value_double(env, args[0], &value0);
double value1;
napi_get_value_double(env, args[1], &value1);
napi_value sum;
// 以上是样板代码
GoInt a = value0;
GoInt b = value1;
GoInt s = golang_add(a, b);
napi_create_double(env, (double)s, &sum);
return sum;
}
// ... 下面是demo代码不贴了
问题
1. 在 ets 中调用。直接表现就是应用崩溃
启动 app 后,一旦触发调用 testNapi.add(1, 2)
就是立马崩溃。
2. 进入debug模式,golang_add 方法调用异常
在 debug模式下断点,可以看到 golang_add
方法是存在的,断点 Step Into
能进入函数内部,调用后查到 cppcrash 日志
Device info:emulator
Build info:emulator 5.1.0.199(SP3DEVC00E199R4P11)
Fingerprint:e6d4cef08713f83aa31465eb1a79e4dee4b4704995a5a30cc43e37f86a4e50fc
Module name:net.tinyleaf.app
Version:1.0.0
VersionCode:1000000
PreInstalled:No
Foreground:Yes
Timestamp:2025-07-23 09:27:58.186
Pid:26323
Uid:20020053
Process name:net.tinyleaf.app
Process life time:254s
Reason:Signal:SIGSEGV(SEGV_MAPERR)@0x000000000000000d probably caused by NULL pointer dereference
看起来是空指针异常?
3. 日志输出问题
另外 golang 的 print 日志也完全没有输出,这我能怀疑没执行到 golang 的 print,但是在 napi_init.cpp
直接打印也是不行的,因为native的日志需要使用 hilog/log.h
才能输出。看日志发现 stdout
和 stderr
是不存在的
apppool E [sandbox_utils.cpp:287]check dir /data/app/el1/public/aot_compiler/ark_cache/net.tinyleaf.app failed, strerror: No such file or directory
apppool E [sandbox_utils.cpp:287]check dir /data/app/el1/public/shader_cache/cloud/net.tinyleaf.app failed, strerror: No such file or directory
apppool E [asan_detector.c:105]Not wrap net.tinyleaf.app.
apppool E [sandbox_utils.cpp:287]check dir /data/app/el1/public/aot_compiler/ark_cache/net.tinyleaf.app failed, strerror: No such file or directory
apppool E [sandbox_utils.cpp:287]check dir /data/app/el1/public/shader_cache/cloud/net.tinyleaf.app failed, strerror: No such file or directory
4. 脱离鸿蒙调用一切正常
全部构建工具链脱离鸿蒙,使用 ubuntu gcc 去调用,一切都能正常使用
GOOS=linux GOARCH=amd64 CGO_ENABLED=1 go build -o libmyapp.so -buildmode=c-shared ./
cpp 调用
#include <stdio.h>
#include "include/libmyapp.h"
int main()
{
GoInt a = 5;
GoInt b = 6;
GoInt sum = add(a, b);
printf("Sum of %lld and %lld is %lld\n", a, b, sum);
return 0;
}
执行后输出
Adding 5 and 6
Sum of 5 and 6 is 11
真的一切正常,但是放到 鸿蒙就不正常
更多关于HarmonyOS 鸿蒙Next中golang编译的so动态库调用异常,日志无输出的实战教程也可以访问 https://www.itying.com/category-94-b0.html
尝试下在子线程调用,之前有人反馈在子线程调用是正常的。主线程调用就崩溃
更多关于HarmonyOS 鸿蒙Next中golang编译的so动态库调用异常,日志无输出的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html
在鸿蒙Next中调用Golang编译的.so动态库异常且无日志输出时,需检查以下方面:
- 确保.so库使用
GOOS=linux GOARCH=arm64
参数编译 - 验证NDK工具链版本匹配鸿蒙Next要求
- 检查动态库是否包含必要的符号表
readelf -s yourlib.so
- 使用
dlopen
加载时检查返回值,并通过dlerror
获取错误信息 - 确认动态库依赖的glibc版本与鸿蒙系统兼容
可通过adb shell cat /proc/xxx/maps
查看进程加载的模块列表,确认.so是否成功加载。
从日志和现象分析,这个问题可能涉及几个关键点:
-
架构匹配问题:虽然您使用了OHOS_LLVMBIN工具链,但GOARCH=amd64可能与鸿蒙模拟器架构不匹配。建议确认模拟器实际架构(通常是arm64),并相应调整GOARCH参数。
-
Go运行时初始化:Golang的C共享库需要显式初始化运行时。在调用任何Go函数前,需要先调用
void _cgo_wait_runtime_init_done()
确保Go运行时已初始化。 -
日志重定向问题:鸿蒙环境下stdout/stderr不可用,建议:
- 在Go代码中使用hilog替换print
- 或通过C导出日志函数到Go层
-
内存管理问题:SIGSEGV错误表明可能存在内存访问越界。建议:
- 检查Go和C之间的类型转换
- 确保GoInt类型与C层定义一致
- 添加边界检查
-
依赖项问题:确认libmyapp.so是否包含所有必要依赖,可使用ldd或readelf检查。
建议尝试以下修改:
- 调整编译目标架构
- 在native代码中添加运行时初始化检查
- 使用hilog替代标准输出
- 添加详细的错误处理逻辑