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 才能输出。看日志发现 stdoutstderr 是不存在的

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

3 回复

尝试下在子线程调用,之前有人反馈在子线程调用是正常的。主线程调用就崩溃

更多关于HarmonyOS 鸿蒙Next中golang编译的so动态库调用异常,日志无输出的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


在鸿蒙Next中调用Golang编译的.so动态库异常且无日志输出时,需检查以下方面:

  1. 确保.so库使用GOOS=linux GOARCH=arm64参数编译
  2. 验证NDK工具链版本匹配鸿蒙Next要求
  3. 检查动态库是否包含必要的符号表readelf -s yourlib.so
  4. 使用dlopen加载时检查返回值,并通过dlerror获取错误信息
  5. 确认动态库依赖的glibc版本与鸿蒙系统兼容

可通过adb shell cat /proc/xxx/maps查看进程加载的模块列表,确认.so是否成功加载。

从日志和现象分析,这个问题可能涉及几个关键点:

  1. 架构匹配问题:虽然您使用了OHOS_LLVMBIN工具链,但GOARCH=amd64可能与鸿蒙模拟器架构不匹配。建议确认模拟器实际架构(通常是arm64),并相应调整GOARCH参数。

  2. Go运行时初始化:Golang的C共享库需要显式初始化运行时。在调用任何Go函数前,需要先调用void _cgo_wait_runtime_init_done()确保Go运行时已初始化。

  3. 日志重定向问题:鸿蒙环境下stdout/stderr不可用,建议:

    • 在Go代码中使用hilog替换print
    • 或通过C导出日志函数到Go层
  4. 内存管理问题:SIGSEGV错误表明可能存在内存访问越界。建议:

    • 检查Go和C之间的类型转换
    • 确保GoInt类型与C层定义一致
    • 添加边界检查
  5. 依赖项问题:确认libmyapp.so是否包含所有必要依赖,可使用ldd或readelf检查。

建议尝试以下修改:

  1. 调整编译目标架构
  2. 在native代码中添加运行时初始化检查
  3. 使用hilog替代标准输出
  4. 添加详细的错误处理逻辑
回到顶部