UI相关应用崩溃常见问题
============

本文档收集整理了一些常见的会导致应用崩溃的ArkUI API错误用法，旨在帮助开发者了解这些会导致应用崩溃问题的错误用法，从而避免在实际应用开发过程中犯类似错误。

#### OH\_NativeXComponent注册的回调函数对象被提前释放

**问题现象**

应用闪退并生成如下cppcrash崩溃栈：

Reason:Signal:SIGSEGV(SEGV\_ACCERR)@0x0000005c5f09a280

#00 pc 0000000000ac9280 \[anon:native\_heap:jemalloc\]
#01 pc 0000000002615120 /system/lib64/platformsdk/libace\_compatible.z.so(OHOS::Ace::NG::XComponentPattern::OnSurfaceDestroyed()+468)
#02 pc 0000000002614b18 /system/lib64/platformsdk/libace\_compatible.z.so(OHOS::Ace::NG::XComponentPattern::OnDetachFromFrameNode(OHOS::Ace::NG::FrameNode\*)+88)
#03 pc 0000000000875294 /system/lib64/platformsdk/libace\_compatible.z.so(OHOS::Ace::NG::FrameNode::~FrameNode()+264)

其中libace\_compatible.z.so栈的最后一个调用帧为XComponentPattern类的OnSurfaceCreated、OnSurfaceChanged、OnSurfaceDestroyed、DispatchTouchEvent方法之一，且#00帧的pc是一个异常地址，通常其最后几位与Reason后面的地址内容一致，这表明某个函数指针存在问题，导致执行时跳转到异常地址。

**可能原因**

应用通过[OH\_NativeXComponent\_RegisterCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-interface-xcomponent-h#oh_nativexcomponent_registercallback)接口注册的[OH\_NativeXComponent\_Callback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-nativexcomponent-native-xcomponent-oh-nativexcomponent-callback)回调函数对象以裸指针形式保存在XComponentPattern对象中。这些回调的生命周期由应用控制。如果应用提前销毁了OH\_NativeXComponent\_Callback回调函数对象，将导致裸指针指向非法内存，引发Use-After-Free问题。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b1/v3/30FE0w3GTeCYPgdfpdlR7w/zh-cn_image_0000002594828280.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=00FB3C58F3F7331FB77F13DBDD0FF77D69390924C577806F8E5376DA6D1A0904)

**解决措施**

onSurfaceDestroy回调是XComponentPattern销毁时调用的最后一个回调，该回调执行完表示组件已经销毁。因此，应用必须确保在onSurfaceDestroy回调执行前，这些回调是有效的。

**参考链接**

相关接口详见[OH\_NativeXComponent Native XComponent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-nativexcomponent-native-xcomponent)。

#### OH\_NativeXComponent对象被提前释放

**问题现象**

应用闪退并生成如下cppcrash崩溃栈：

#00 pc 00000000000c8b3c /system/lib64/libc++.so(std::\_\_h::basic\_string<char, std::\_\_h::char\_traits<char>, std::\_\_h::allocator<char>>::basic\_string(std::\_\_h::basic\_string<char, std::\_\_h::char\_traits<char>, std::\_\_h::allocator<char>> const&)+16)
#01 pc 0000000000034f64 /system/lib64/libace\_ndk.z.so(OH\_NativeXComponent::GetXComponentId(char\*, unsigned long\*)+76)
#02 pc 00000000000867c0 /data/storage/el1/bundle/libs/arm64/librenderer.so

其中栈顶附近内容为libace\_ndk.z.so(OH\_NativeXComponent::XXX...)，且下一帧是应用so。

**可能原因**

OH\_NativeXComponent使用裸指针管理。应用侧持有其裸指针。如果在其生命周期结束后仍然调用相关接口，会导致Use-After-Free问题。

**解决措施**

系统通过onSurfaceDestroy回调通知应用OH\_NativeXComponent已销毁。应用必须确保在onSurfaceDestroy回调执行完毕后不再调用OH\_NativeXComponent相关接口。

**参考链接**

相关接口详见[OH\_NativeXComponent Native XComponent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-nativexcomponent-native-xcomponent)。

#### @Consume缺少匹配的@Provide

**问题现象**

应用闪退并生成如下jscrash崩溃栈：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5/v3/s0G3blPFQPSAAkEwy81U1A/zh-cn_image_0000002625187727.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=B8AA19F439ECE45FAD4C16BA5DA8A7D84DB1094394880139BB721363C3154493)

**可能原因**

报错发生在@Consume初始化阶段，原因是@Consume初始化时仅通过key匹配对应的@Provide变量。如果未找到对应的@Provide，就会出现报错（missing @Provide）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/08/v3/erq6ASLpTjGM0s55PcSZ0w/zh-cn_image_0000002625107871.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=B5E26D5F56081E4B1E25A7F3232259F73F243105853E9E0D152DA0F50473E561)

**解决措施**

排查组件树时，确保@Provide装饰的变量在祖先组件中定义，这些变量被视为提供给后代的状态变量。@Consume装饰的变量在后代组件中使用，用于绑定祖先组件提供的变量。如果@Consume绑定的key在祖先组件中未定义，会导致报错。请从用法角度进行排查。

**参考链接**

[跨组件层级双向同步](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-new-provider-and-consumer)。

#### @Link数据源类型错误

**问题现象**

应用闪退并生成如下jscrash崩溃栈：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/dHUcHjS4T2GJl8gJ_Jc4yg/zh-cn_image_0000002594668354.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=CF968352A33C3C4CF92DCE6E6A53080F75016E81B7320596C02E8B72F5EBC211)

从API version 23开始，添加对@Link数据源错误的校验，运行时错误变为编译期报错：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9f/v3/pw5jZvIVTDiOEVKWTAYQuw/zh-cn_image_0000002594828282.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=D32DF32C640BB146BAA3091B4177D8498A0CD58A81DE7419B84A679C1A40F0F6)

**可能原因**

报错发生在@Link初始化阶段，原因是@Link初始化时会注册到父组件并调用父组件的addSubscriber方法。如果此时数据源的类型与@Link不完全一致，或者使用常量初始化@Link，会导致该方法无法调用，从而引发“is not callable”错误。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8a/v3/wkTkDDatSIuHXTYbH6KxNQ/zh-cn_image_0000002625187729.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=9E701D33AE35EB18F9068C564CE2E7351F62E907F4694C1C05B8D51113B19A35)

**解决措施**

排查@Link的数据源，确认其是否为状态变量，并确保数据源的类型与@Link的类型一致。

**参考链接**

[父子双向同步](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-link)。

#### @Provide缺少重写声明

**问题现象**

应用闪退并生成如下jscrash崩溃栈：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7c/v3/WWzE8te8SQuMIyiawGwkAA/zh-cn_image_0000002625107873.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=5C8FBE2DFE4E38E668802DD2ECF0C7D19A03124994A2083BB6D1EB7E6C8D0900)

**可能原因**

报错发生在@Provide初始化阶段，原因是@Provide重写需要声明allowOverride。声明后，别名和属性名都可以被覆盖。如果未声明且存在重复的别名或属性名，将导致错误（duplicate @Provide property with name xxxxx）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c1/v3/i3ZrkBxkSDmUerH8BPXlzw/zh-cn_image_0000002594668356.png?HW-CC-KV=V1&HW-CC-Date=20260612T073323Z&HW-CC-Expire=86400&HW-CC-Sign=2BC08A8996F6127653694F53B0B7D6A7CB0D490505559F22568D764DA9688A6E)

**解决措施**

需要检查@Provide是否使用了allowOverride声明。如果没有使用allowOverride，则这样使用是不合规的。只有在声明了allowOverride之后，才会允许重写，并且子组件的@Consume会根据别名或属性名找到并使用距离它最近的父节点上的@Provide值。

**参考链接**

[跨组件层级双向同步](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-new-provider-and-consumer)。