Star134
89
代码
代码
Issues4
Pull Requests10
项目讨论
Wiki
分析
Star134
89
wenwenyangwenwenyangdoc：文档整改
d94f521d创建于 7月23日历史提交

Flutter module 调试案例

场景场景问题背景

Flutter社区从3.32版本开始，默认开启线程合并，即 1.ui 线程和应用的UI线程合并，这样会提升 1.ui 线程的线程优先级，从而提升性能。线程合并开启时，Dart 代码的断点调试会阻塞应用UI线程。应用如果不是通过调试模式运行，会因为应用的 Watchdog 机制，UI 线程阻塞会导致触发 THREAD_BLOCK_6S 事件，应用闪退，Flutter 出现 device lost。当开发者手动点击图标启动应用时，手机不知道这个应用要进行调试，应用 Watchdog会开启，不允许UI线程阻塞，导致崩溃。

这个问题可以通过操作比秒，Flutter attach之后，通过 DevEco Studio的调试模式去启动应用，应用就会以调试模式运行，也就不会有线程上报 THREAD_BLOCK_6S的问题。应用的debug包不代表调试模式，该操作方法需要应用重新运行。

堆栈特征分析

Reason:BUSSINESS_THREAD_BLOCK_6S
appfreeze:com.xxx.app BUSSINESS_THREAD_BLOCK_6S at 20250924172744
STRINGID:BUSSINESS_THREAD_BLOCK_6S
......
DOMAIN = AAFWK
EVENTNAME = BUSSINESS_THREAD_BLOCK_3S

线程1(Tid:65131, Name:com.hnair.app):
#00 pc 0000000000156a74 /system/lib/ld-musl-aarch64.so.1(epoll_wait+80)
#01 pc 00000000000192bc ...(EpollIoWaiter::WaitFor...)
#02 pc 0000000000021660 ...(EventQueue::WaitUnilLocked...)
#03 pc 0000000000022fdc ...(EventQueueBase::GetEvent()+216)
#04 pc 000000000002cf60 ...(EventRunnerImpl::Run()+928)
#05 pc 00000000000302f0 ...(EventRunner::Run()+528)
#06 pc 00000000000b9ca0 ...(MainThread::Start()+400)

线程2(Tid:150, Name:RSRenderThread):等待事件(epoll_wait),标准的渲染线程空闲状态
线程3(Tid:227, Name:gpu-async-work):等待条件变量,标准的GPU工作线程空闲状态

通过当前堆栈信息，主线程正在执行epoll_wait。在HarmonyOS(和 Android类似)的应用框架中，这是主线程消息循环的空闲状态。它正在等待新的消息（如ui事件生命周期回调等）进入队列。既然主线程是‘空闲’的它就没有在做耗时操作（没有死循环，没有在执行沉重的业务逻辑，没有在等待锁）一个空闲的主线程理论上会立刻响应系统的ping/pong心跳检测，不应该触发BUSSINESS_THREAD_BLOCK_6S（业务线程阻塞6s）。唯一可能就是整个进程或主线程被外部强制挂起，不再参与CPU调度。在正常的开发场景中导致这种情况最常见的原因时使用了某种调试工具，命中了断点。

排除其他可能性： 死锁：堆栈信息应该停留在pthread_mutex_lock 或 pthread_cond_wait等锁相关的调用中 CPU抢占/饥饿：如果因为CPU被其他高优先级线程占满，主线程堆栈通常会显示在某个具体业务代码的执行点，而不会待在消息循环的epoll_wait里 其他线程阻塞：看报错明确指向的是Tid:65131（主线程），而RSRenderThread和gpu-async-worke的堆栈也是正常的等待状态，没有异常死锁迹象

分析总结：结合”主线程处于消息循环空闲态（epoll_wait）“ + ”系统判定其阻塞超过6秒未响应“这一典型特征，可以判定这并非应用本身的业务BUG，而是因为在调试过程中打断了应用的正常运行（命中断点）。导致系统看门狗误杀。

调试步骤

以 multiple_flutters Demo 为例：

  1. 完成 module 的编译集成

  2. 使用 DevEco Studio 工具打开 multiple_flutters_ohos 项目，连接真机或模拟器

    image-20260520172030808

  3. 打开 Project Structure -> Signing Configs ，配置签名

    image-20260520172227619

  4. 点击 DevEco Studio 工具 debug 按钮运行应用

    image-20260520172637959

  5. 应用debug启动成功后，使用 Android Studio 工具打开 multiple_flutters_module 工程

    image-20260520172930865

  6. 点击 Android Studio 工具栏 Flutter Attach 按钮，等待链接

    image-20260520173110209

  7. 断点需要调试的代码后，等待链接

    image-20260520173247088

  8. 打开 flutter module 页面，链接成功

    image-20260520173533296

  9. 成功进入断点，不会出现闪退。即可正常调试