com.facebook.react.fabric.mounting.SurfaceMountingManager.getViewState

[UmairHussain123]

Description

i am facing this issue in react-native 81.5.
Issue details
com.facebook.react.fabric.mounting.SurfaceMountingManager.getViewState

com.facebook.react.bridge.RetryableMountingLayerException                                                                                     

Type: com.facebook.react.bridge.RetryableMountingLayerException

Exception com.facebook.react.bridge.RetryableMountingLayerException:
at com.facebook.react.fabric.mounting.SurfaceMountingManager.getViewState (SurfaceMountingManager.java:1108)
at com.facebook.react.fabric.mounting.SurfaceMountingManager.addViewAt (SurfaceMountingManager.java:354)
at com.facebook.react.fabric.mounting.mountitems.IntBufferBatchMountItem.execute (IntBufferBatchMountItem.kt:111)
at com.facebook.react.fabric.mounting.MountItemDispatcher.executeOrEnqueue (MountItemDispatcher.kt:312)
at com.facebook.react.fabric.mounting.MountItemDispatcher.dispatchMountItems (MountItemDispatcher.kt:221)
at com.facebook.react.fabric.mounting.MountItemDispatcher.tryDispatchMountItems (MountItemDispatcher.kt:88)
at com.facebook.react.fabric.FabricUIManager$DispatchUIFrameCallback.doFrameGuarded (FabricUIManager.java:1484)
at com.facebook.react.uimanager.GuardedFrameCallback.doFrame (GuardedFrameCallback.kt:25)
at com.facebook.react.modules.core.ReactChoreographer.frameCallback$lambda$1 (ReactChoreographer.kt:59)
at com.facebook.react.modules.core.ReactChoreographer.$r8$lambda$nSkFhrr5T7rop_XKwzlLov4NLLw (Unknown Source)
at com.facebook.react.modules.core.ReactChoreographer$$ExternalSyntheticLambda0.doFrame (D8$$SyntheticClass)
at android.view.Choreographer$CallbackRecord.run (Choreographer.java:1232)
at android.view.Choreographer$CallbackRecord.run (Choreographer.java:1242)
at android.view.Choreographer.doCallbacks (Choreographer.java:902)
at android.view.Choreographer.doFrame (Choreographer.java:830)
at android.view.Choreographer$FrameDisplayEventReceiver.run (Choreographer.java:1217)
at android.os.Handler.handleCallback (Handler.java:942)
at android.os.Handler.dispatchMessage (Handler.java:99)
at android.os.Looper.loopOnce (Looper.java:201)
at android.os.Looper.loop (Looper.java:288)
at android.app.ActivityThread.main (ActivityThread.java:8194)
at java.lang.reflect.Method.invoke
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run (RuntimeInit.java:703)
at com.android.internal.os.ZygoteInit.main (ZygoteInit.java:911)

Steps to reproduce

React Native Version

0.81.5

Affected Platforms

Runtime - Android

Output of npx @react-native-community/cli info

info Fetching system and libraries information...
System:
  OS: macOS 15.7.1
  CPU: (8) arm64 Apple M2
  Memory: 216.02 MB / 8.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 22.13.1
    path: /Users/muhammadhanan/.nvm/versions/node/v22.13.1/bin/node
  Yarn: Not Found
  npm:
    version: 10.9.2
    path: /Users/muhammadhanan/.nvm/versions/node/v22.13.1/bin/npm
  Watchman:
    version: 2024.12.02.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.16.2
    path: /Users/muhammadhanan/.rbenv/shims/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.0
      - iOS 26.0
      - macOS 26.0
      - tvOS 26.0
      - visionOS 26.0
      - watchOS 26.0
  Android SDK: Not Found
IDEs:
  Android Studio: 2024.2 AI-242.23339.11.2421.12483815
  Xcode:
    version: 26.0/17A324
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.13
    path: /usr/bin/javac
  Ruby:
    version: 3.2.0
    path: /Users/muhammadhanan/.rbenv/shims/ruby
npmPackages:
  "@react-native-community/cli":
    installed: 20.0.0
    wanted: 20.0.0
  react:
    installed: 19.1.0
    wanted: 19.1.0
  react-native:
    installed: 0.81.5
    wanted: 0.81.5
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: true
iOS:
  hermesEnabled: true
  newArchEnabled: true

info React Native v0.83.0 is now available (your project is running on v0.81.5).
info Changelog: https://github.com/facebook/react-native/releases/tag/v0.83.0
info Diff: https://react-native-community.github.io/upgrade-helper/?from=0.81.5&to=0.83.0
info For more info, check out "https://reactnative.dev/docs/upgrading?os=macos".

Stacktrace or Logs

Exception com.facebook.react.bridge.RetryableMountingLayerException:
  at com.facebook.react.fabric.mounting.SurfaceMountingManager.getViewState (SurfaceMountingManager.java:1108)
  at com.facebook.react.fabric.mounting.SurfaceMountingManager.addViewAt (SurfaceMountingManager.java:354)
  at com.facebook.react.fabric.mounting.mountitems.IntBufferBatchMountItem.execute (IntBufferBatchMountItem.kt:111)
  at com.facebook.react.fabric.mounting.MountItemDispatcher.executeOrEnqueue (MountItemDispatcher.kt:312)
  at com.facebook.react.fabric.mounting.MountItemDispatcher.dispatchMountItems (MountItemDispatcher.kt:221)
  at com.facebook.react.fabric.mounting.MountItemDispatcher.tryDispatchMountItems (MountItemDispatcher.kt:88)
  at com.facebook.react.fabric.FabricUIManager$DispatchUIFrameCallback.doFrameGuarded (FabricUIManager.java:1484)
  at com.facebook.react.uimanager.GuardedFrameCallback.doFrame (GuardedFrameCallback.kt:25)
  at com.facebook.react.modules.core.ReactChoreographer.frameCallback$lambda$1 (ReactChoreographer.kt:59)
  at com.facebook.react.modules.core.ReactChoreographer.$r8$lambda$nSkFhrr5T7rop_XKwzlLov4NLLw (Unknown Source)
  at com.facebook.react.modules.core.ReactChoreographer$$ExternalSyntheticLambda0.doFrame (D8$$SyntheticClass)
  at android.view.Choreographer$CallbackRecord.run (Choreographer.java:1232)
  at android.view.Choreographer$CallbackRecord.run (Choreographer.java:1242)
  at android.view.Choreographer.doCallbacks (Choreographer.java:902)
  at android.view.Choreographer.doFrame (Choreographer.java:830)
  at android.view.Choreographer$FrameDisplayEventReceiver.run (Choreographer.java:1217)
  at android.os.Handler.handleCallback (Handler.java:942)
  at android.os.Handler.dispatchMessage (Handler.java:99)
  at android.os.Looper.loopOnce (Looper.java:201)
  at android.os.Looper.loop (Looper.java:288)
  at android.app.ActivityThread.main (ActivityThread.java:8194)
  at java.lang.reflect.Method.invoke
  at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run (RuntimeInit.java:703)
  at com.android.internal.os.ZygoteInit.main (ZygoteInit.java:911)

MANDATORY Reproducer

https://github.com/hhcdropshipping/hhcdsapp

Screenshots and Videos

[react-native-bot]

Warning

Missing reproducer: We could not detect a reproducible example in your issue report. Reproducers are mandatory and we can accept only one of those as a valid reproducer:

• For majority of bugs: send us a Pull Request with the RNTesterPlayground.js edited to reproduce your bug.
• If your bug is UI related: a Snack
• If your bug is build/upgrade related: a project using our Reproducer Template

You can read more about about it on our website: How to report a bug.

[oleksandr-dziuban]

Same issue for us, and it's already a bunch of issues created regarding that:

For RN repo:
#49077

For Reanimated repo:
software-mansion/react-native-reanimated#7493 (comment)

[react-native-bot]

This issue is waiting for author's feedback since 24 days. Please provide the requested feedback or this will be closed in 7 days.

[react-native-bot]

This issue was closed because the author hasn't provided the requested feedback after 7 days.

[vinaciotm]

same here. Some temp solution?

[dhairyasenjaliya]

hy any updates on this

[MrKinq]

Hello,

This also happens on RN 0.85.x.

In my case it seems to be triggered by Android Fabric mounting + virtualized lists / Reanimated-heavy views. The crash happens inside SurfaceMountingManager.addViewAt(...), usually with something like:

addViewAt: failed to insert view [...] into parent [...] at index X
IndexOutOfBoundsException: index=X count=0

A simple workaround on the JS side was to enable clipping only on Android for the scrolling lists:

<FlatList
...
removeClippedSubviews={Platform.OS === 'android'}
/>

This reduced the crash because Android keeps fewer offscreen native views alive while Fabric is mounting/unmounting list items.

The native workaround is to patch this file:

node_modules/react-native/ReactAndroid/src/main/java/com/facebook/react/fabric/mounting/SurfaceMountingManager.kt

The idea is to turn recoverable Fabric/Android mounting races into soft exceptions instead of fatal crashes.

Patch 1: replace the full addViewAt(...) function

@UiThread
  public fun addViewAt(parentTag: Int, tag: Int, index: Int): Unit {
    UiThreadUtil.assertOnUiThread()
    if (isStopped) {
      return
    }
  
    val parentViewState = getNullableViewState(parentTag)
    if (parentViewState == null) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException("Unable to find parent viewState for tag: [$parentTag] for addViewAt. Child tag: [$tag] index: [$index]"),
      )
      return
    }
  
    if (parentViewState.view !is ViewGroup) {
      val message =
          "Unable to add a view into a view that is not a ViewGroup. ParentTag: $parentTag - Tag: $tag - Index: $index"
      FLog.e(TAG, message)
      throw IllegalStateException(message)
    }
  
    val parentView = parentViewState.view as ViewGroup
    val viewState = getNullableViewState(tag)
    if (viewState == null) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException("Unable to find child viewState for tag: [$tag] for addViewAt. Parent tag: [$parentTag] index: [$index]"),
      )
      return
    }
  
    val view = viewState.view
    if (view == null) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException("Unable to find child view for tag: [$tag] for addViewAt. Parent tag: [$parentTag] index: [$index]"),
      )
      return
    }
  
    if (SHOW_CHANGED_VIEW_HIERARCHIES) {
      FLog.e(TAG, "addViewAt: [$tag] -> [$parentTag] idx: $index BEFORE")
      logViewHierarchy(parentView, false)
    }
  
    val viewParent = view.parent
    if (viewParent != null) {
      val actualParentId = if (viewParent is ViewGroup) viewParent.id else View.NO_ID
      ReactSoftExceptionLogger.logSoftException(
          TAG,
          IllegalStateException(
              "addViewAt: cannot insert view [$tag] into parent [$parentTag]: View already has a parent: [$actualParentId]  Parent: ${viewParent.javaClass.simpleName} View: ${view.javaClass.simpleName}"
          ),
      )
  
      if (viewParent is ViewGroup) {
        viewParent.removeView(view)
      }
  
      erroneouslyReaddedReactTags.add(tag)
    }
  
    val viewGroupManager = getViewGroupManager(parentViewState)
    val safeIndex = index.coerceIn(0, parentView.childCount)
  
    try {
      viewGroupManager.addView(parentView, view, safeIndex)
    } catch (e: IndexOutOfBoundsException) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException(
              "addViewAt recovered from invalid index. Child [$tag] parent [$parentTag] requested index [$index] safe index [$safeIndex] parent childCount [${parentView.childCount}]. ${e.message}"
          ),
      )
  
      if (view.parent == null) {
        try {
          viewGroupManager.addView(parentView, view, parentView.childCount.coerceAtLeast(0))
        } catch (fallbackException: RuntimeException) {
          ReactSoftExceptionLogger.logSoftException(
              ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
              ReactNoCrashSoftException(
                  "addViewAt fallback failed. Child [$tag] parent [$parentTag] requested index [$index] parent childCount [${parentView.childCount}]. ${fallbackException.message}"
              ),
          )
        }
      }
  
      return
    } catch (e: IllegalStateException) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException(
              "addViewAt recovered from IllegalStateException. Child [$tag] parent [$parentTag] requested index [$index] safe index [$safeIndex] parent childCount [${parentView.childCount}]. ${e.message}"
          ),
      )
      return
    }
  
    if (SHOW_CHANGED_VIEW_HIERARCHIES) {
      UiThreadUtil.runOnUiThread {
        FLog.e(TAG, "addViewAt: [$tag] -> [$parentTag] idx: $safeIndex AFTER")
        logViewHierarchy(parentView, false)
      }
    }
 }

Patch 2: replace the full private updateProps(...) function

@UiThread
  private fun updateProps(
      reactTag: Int,
      props: ReadableMap,
      shouldSkipSynchronousMountPropsOverride: Boolean,
  ) {
    if (isStopped) {
      return
    }
  
    val viewState = getNullableViewState(reactTag)
    if (viewState == null) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException("Unable to find viewState for tag: $reactTag for updateProps"),
      )
      return
    }
  
    if (
        ReactNativeFeatureFlags.overrideBySynchronousMountPropsAtMountingAndroid() &&
            !shouldSkipSynchronousMountPropsOverride &&
            tagToSynchronousMountProps.containsKey(reactTag)
    ) {
      val modifiedProps = WritableNativeMap()
      modifiedProps.merge(props)
      val directPropsMap = checkNotNull(tagToSynchronousMountProps[reactTag])
      overridePropsReadableMap(directPropsMap, modifiedProps)
      viewState.currentProps = ReactStylesDiffMap(modifiedProps)
    } else {
      viewState.currentProps = ReactStylesDiffMap(props)
    }
  
    val view = viewState.view
    if (view == null) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException("Unable to find view for tag: $reactTag for updateProps"),
      )
      return
    }
  
    val viewManager = viewState.viewManager
    if (viewManager == null) {
      ReactSoftExceptionLogger.logSoftException(
          ReactSoftExceptionLogger.Categories.SURFACE_MOUNTING_MANAGER_MISSING_VIEWSTATE,
          ReactNoCrashSoftException("Unable to find viewManager for tag: $reactTag for updateProps"),
      )
      return
    }
  
    viewManager.updateProperties(view, viewState.currentProps)
  }

In my RN version these imports were already present, but if they are missing, add:

import com.facebook.react.bridge.ReactNoCrashSoftException
import com.facebook.react.bridge.ReactSoftExceptionLogger

Then generate the patch with:

npx patch-package react-native

This is only a workaround, not necessarily the correct upstream fix. It prevents recoverable Android Fabric mounting races from becoming fatal crashes. If a view was already removed/clipped, or if Fabric tries to insert a child using a stale index, it logs a soft exception and returns instead of crashing the app.