Flutter应用模拟器正常但真机安装后白屏无响应问题求助

问题描述 #

Flutter应用在模拟器运行正常，但通过flutter build apk或flutter build apk --split-per-abi --no-sound-null-safety构建的APK安装到真机后，卡在白屏状态无响应。此外，模拟器启动时偶尔抛出以下断言错误：

Incorrect use of ParentDataWidget.
The ParentDataWidget Expanded(flex: 1) wants to apply ParentData of type FlexParentData to a
RenderObject, which has been set up to accept ParentData of incompatible type StackParentData.
Usually, this means that the Expanded widget has the wrong ancestor RenderObjectWidget. Typically,
Expanded widgets are placed directly inside Flex widgets.

修改首屏内容后问题仍未解决，项目配置信息如下：

Pubspec.yaml #

name: aracqr
description: A new Flutter project.

publish_to: 'none'

version: 1.0.0+1

environment:
  sdk: ">=2.17.0 <3.0.0"

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.5
  firebase_core: ^1.20.1
  http: ^0.13.5
  firebase_messaging: ^12.0.2
  font_awesome_flutter: ^10.1.0
  flutter_svg: ^1.1.3
  qr_flutter: ^4.0.0
  firebase_auth: ^3.6.3
  introduction_screen: ^3.0.2
  cloud_firestore: ^3.4.4

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true
  assets:
   - assets/
  fonts:
   - family: roboto
     fonts:
       - asset: fonts/regular.ttf
       - asset: fonts/bold.ttf
       - asset: fonts/black.ttf

Android Manifest.xml #

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="store.sezenhs.aracqr">

   <application
        android:allowBackup="false"
        android:fullBackupContent="false"
        android:label="aracqr"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">
        <activity
            android:name=".MainActivity"
            android:exported="true"
            android:launchMode="singleTop"
            android:theme="@style/LaunchTheme"
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
            android:hardwareAccelerated="true"
            android:windowSoftInputMode="adjustResize">
            <meta-data
              android:name="io.flutter.embedding.android.NormalTheme"
              android:resource="@style/NormalTheme"
              />
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        <meta-data
            android:name="flutterEmbedding"
            android:value="2" />
    </application>
    <uses-permission android:name="android.permission.INTERNET"/>
</manifest>

白屏问题排查步骤 #

• 抓取真机运行日志：使用adb logcat命令过滤Flutter相关日志，重点查找初始化失败、资源加载错误、权限拒绝等异常信息，定位卡屏的具体原因。
• 验证Firebase配置：项目依赖Firebase服务，需确认：
  • google-services.json文件已正确放置在android/app目录下；
  • Firebase控制台已添加该应用的release版本SHA-1指纹；
  • 所有Firebase服务在release环境下已正确启用。
• 检查资源打包情况：确认assets目录下的文件完整且路径配置正确，执行flutter clean清理缓存后重新构建APK，避免资源打包遗漏。
• 排查空安全问题：由于使用--no-sound-null-safety构建，需检查代码中是否存在未处理的空值引用，release模式下这类错误会直接导致应用卡死而非抛出明确异常。
• 优化启动初始化逻辑：检查main函数中的异步初始化操作（如Firebase.initializeApp()），确保使用async/await或FutureBuilder处理异步流程，避免同步阻塞UI线程。
• 升级依赖版本：当前Firebase相关依赖版本较旧，可能与Flutter SDK 2.17.0存在兼容性问题，尝试升级到稳定版依赖后重新构建。

断言错误解决方案 #

该错误是由于Expanded组件的父容器类型错误导致的：Expanded必须直接作为Row或Column（Flex类型组件）的子组件，不能嵌套在Stack或其他非Flex容器中。

• 全局搜索代码中的Expanded组件，逐一检查其父组件类型；
• 将错误放置的Expanded移动到Row/Column下，或替换为Container等支持自定义尺寸的组件；
• 即使首屏已修改，也要检查其他页面、自定义组件中是否存在同类布局错误。

内容的提问来源于stack exchange，提问作者Hüseyin Sezen