[iOS] Prebuilt React-Core Release artifacts are built with NSAssertions enabled — RCTAssert failures become fatal NSRangeException crashes in production
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- C++
- Sterne
- 127k
- Forks
- 25.3k
- Ø Merge
- 1 T. 23 Std.
- Gemergte PRs (30 T.)
- 4
Beschreibung
Description
The prebuilt React Native Core Release artifacts published to Maven Central are built without NS_BLOCK_ASSERTIONS, so every RCTAssert in the framework is compiled in and live in production apps. When React Native is built from source, the standard Release configuration (ENABLE_NS_ASSERTIONS = NO) strips these asserts, so they are no-ops in production.
This has two consequences:
-
Assert conditions that are benign in a source Release build become fatal in a prebuilt Release build. Example: in
RCTViewComponentView unmountChildComponentView:index:, theindexparameter is used only insideRCTAssert. With asserts stripped, a stale/mismatched index is harmless — the method just callsremoveFromSuperviewon the correct child. With asserts live, the same situation crashes the app. -
The crash is worse than an assertion failure. The assert at
RCTViewComponentView.mm(v0.85.3, L154–L177) eagerly evaluates its message arguments, including[[self.currentContainerView.subviews objectAtIndex:index] tag]. When the assert condition fails becauseindexis out of bounds, formatting the message itself throwsNSRangeException— the app dies while trying to report the assert.
We hit this in production: the first release of our app on prebuilt React Native Core (RN 0.85.3) started crashing with NSRangeException in unmountChildComponentView:index: on a screen that structurally remounts children of a legacy interop view (react-native-linear-gradient 2.8.3) inside an animation loop. Our previous release (RN 0.83.9, built from source) had zero crashes on the identical screen code. iOS only, observed on iOS 18 and iOS 26.
Steps to reproduce
No app is needed — the defect is verifiable directly on the published artifacts:
# RN 0.85.3 release artifact
curl -sL https://repo1.maven.org/maven2/com/facebook/react/react-native-artifacts/0.85.3/react-native-artifacts-0.85.3-reactnative-core-release.tar.gz | tar -xz
strings React.xcframework/ios-arm64/React.framework/React | grep "Attempt to unmount"
Output (these strings only exist in the binary if the RCTAssert call sites were compiled in):
Attempt to unmount a view which is mounted inside different view. (parent: %@, child: %@, index: %@)
Attempt to unmount a view which has a different index. (parent: %@, child: %@, index: %@, actual index: %@, tag at index: %@)
The same check on the 0.86.0 release artifact (react-native-artifacts-0.86.0-reactnative-core-release.tar.gz) shows the same result, so the current stable is equally affected.
For comparison, a source-built Release archive of the same RN version does not contain these strings (asserts stripped by ENABLE_NS_ASSERTIONS = NO).
Production stack trace
NSRangeException: *** -[__NSSingleObjectArrayI objectAtIndex:]: index 1 beyond bounds [0 .. 0]
CoreFoundation __exceptionPreprocess
libobjc.A objc_exception_throw
CoreFoundation -[__NSSingleObjectArrayI objectAtIndex:]
React -[RCTViewComponentView unmountChildComponentView:index:]
React -[RCTMountingManager performTransaction:] (block)
React facebook::react::TelemetryController::pullTransaction
React -[RCTMountingManager performTransaction:]
React -[RCTMountingManager initiateTransaction:]
libdispatch _dispatch_main_queue_drain
...
Additional observation
Reproducing the same UI flow on a source-built Debug binary (where assertions are also enabled) does not trip the assert, while the prebuilt binary does. We have not isolated why, but it suggests the prebuilt binary may also differ behaviorally from a source build of the same version (build-time flags?). The primary, easily verifiable defect remains the assertions in the Release artifact.
Workaround
RCT_USE_PREBUILT_RNCORE=0 (build React Native Core from source). Verified: the crash disappears and Release builds strip the asserts as before.
Suggested fix
- Build the
-releaseprebuilt artifacts withENABLE_NS_ASSERTIONS = NO/NS_BLOCK_ASSERTIONSdefined, matching what a source Release build produces. - Independently: make the assert message at
RCTViewComponentView.mmbounds-safe (it currently indexes out of bounds while formatting the message for the exact condition it is asserting against).
React Native Version
0.85.3 (artifact defect also verified on 0.86.0)
Affected Platforms
Runtime: iOS. New Architecture (Fabric).
Output of npx react-native info
System:
OS: macOS 26.5.1
CPU: (12) arm64 Apple M2 Pro
Binaries:
Node: 24.14.0
Yarn: 4.16.0
npm: 11.9.0
Watchman: 2025.06.30.00
SDKs:
iOS SDK: 26.5
Xcode: 26.6/17F113
Ruby: 3.3.10
react-native: 0.85.3
Hermes: enabled
New Architecture: enabled
Reproducer
Not applicable — the defect is in the published build artifacts themselves; the shell commands under "Steps to reproduce" demonstrate it without an app.
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit RCTViewComponentView.mm und der Build-Konfiguration für Release-Artefakte; vergleiche das veröffentlichte 0.85.3- oder 0.86.0-Archiv mit einem aus dem Quellcode erstellten Release-Archiv. Führe die curl-, tar- und strings-Befehle aus dem Issue aus, um Assertion-Symbole zu überprüfen, und bestätige anschließend, dass die Release-Artefakte diese nicht mehr enthalten und dass die Assert-Meldung nicht über die Grenzen von subviews hinaus indiziert.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- ios, objective-c, react-native
- Bereich
- build-system, mobile
- Issue-Typ
- Bug
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Ruhig
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 52/100