Android Handler报错：指定消息队列同步屏障令牌未发布/已移除求助

崩溃栈信息 #

2022-10-14 10:36:35.026 4530-4530/com.skkj.app.ditie.gxc I/BlockMonitor: dispatchingThrewException In MainThread
2022-10-14 10:36:35.026 4530-4530/com.skkj.app.ditie.gxc D/AndroidRuntime: Shutting down VM
2022-10-14 10:36:35.027 4530-4530/com.skkj.app.ditie.gxc I/QarthLog: [PatchStore] createDisableExceptionQarthFile
2022-10-14 10:36:35.027 4530-4530/com.skkj.app.ditie.gxc I/QarthLog: [PatchStore] create disable file for com.skkj.app.ditie.gxc uid is 10188
2022-10-14 10:36:35.027 4530-4530/com.skkj.app.ditie.gxc E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.skkj.app.ditie.gxc, PID: 4530
    java.lang.IllegalStateException: 指定的消息队列同步屏障令牌未发布或已被移除。
        at android.os.MessageQueue.removeSyncBarrier(MessageQueue.java:587)
        at android.view.ViewRootImpl.doTraversal(ViewRootImpl.java:2160)
        at android.view.ViewRootImpl$TraversalRunnable.run(ViewRootImpl.java:8887)
        at android.view.Choreographer$CallbackRecord.run(Choreographer.java:1280)
        at android.view.Choreographer.doCallbacks(Choreographer.java:1019)
        at android.view.Choreographer.doFrame(Choreographer.java:911)
        at android.view.Choreographer$FrameDisplayEventReceiver.run(Choreographer.java:1248)
        at android.os.Handler.handleCallback(Handler.java:900)
        at android.os.Handler.dispatchMessage(Handler.java:103)
        at android.os.Looper.loop(Looper.java:219)
        at android.app.ActivityThread.main(ActivityThread.java:8668)
        at java.lang.reflect.Method.invoke(Native Method)
        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:513)
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1109)
2022-10-14 10:36:35.042 4530-4530/? I/Process: Sending signal. PID: 4530 SIG: 9
2022-10-14 10:36:42.635 4589-4736/com.skkj.app.ditie.gxc W/Settings: Setting adb_e

问题原因 #

这个异常是因为调用MessageQueue.removeSyncBarrier()时，传入的同步屏障令牌不存在——要么从未通过postSyncBarrier()发布过该令牌，要么已经被移除过一次。从崩溃栈来看，是系统ViewRootImpl执行UI遍历操作时触发的，大概率是主线程消息队列的同步屏障状态被异常篡改。

解决方案 #

• 检查手动同步屏障调用：如果代码中直接调用过MessageQueue.postSyncBarrier()和removeSyncBarrier()，必须保证每个发布的令牌只被移除一次，避免重复调用removeSyncBarrier。
• 排查UI线程干扰：
  • 确保所有UI操作都在主线程执行，后台线程更新UI会导致ViewRootImpl的消息队列状态紊乱。
  • 检查是否使用了自定义Handler/Looper替换或干扰了主线程的消息循环，这类操作容易破坏系统的帧调度逻辑。
• 三方库排查：如果项目使用了动画、UI相关三方库，排查是否是库内部不当使用同步屏障导致的问题，可尝试临时禁用相关库验证。
• 应急防护（不推荐长期使用）：如果暂时找不到根源，可以通过反射或自定义ViewRootImpl的方式捕获该异常，避免App直接崩溃，但这只是权宜之计，仍需找到根本原因修复。

内容的提问来源于stack exchange，提问作者A hui