Android 12(API31)根启动Activity onCreate未调用解决方案

问题背景 #

开发Android应用时，通常会指定一个**根启动Activity（Root Launcher Activity）**作为应用图标点击入口，启动时读取本地偏好配置，判断是否直接跳转至其他目标页面。
在Android 11（API 30）及更低版本中，以下实现可以稳定运行：

旧版实现代码 #

LoginActivity.kt

/** 应用图标点击后的主入口Activity */
class LoginActivity : AppCompatActivity() {

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 用户已登录则不展示登录页，直接跳转欢迎页
    val prefs = PreferenceManager.getDefaultSharedPreferences(this)
    val userIsLoggedIn = prefs.getBoolean("USER_IS_LOGGED_IN", false)
    if (userIsLoggedIn) {
      launchWelcomeScreenActivity()
      finish() // 关闭登录页
    } else {
      displayLoginFields()
    }
  }

  override fun onResume() {
    super.onResume()
    Log.d("MyApp", "onResume()")
  }
  // 其余业务逻辑
}

AndroidManifest.xml配置

...
<application
  android:icon="@drawable/app_icon">
  <activity
    android:name=".LoginActivity"
    android:exported="true">
    <!-- 配置为应用主入口，在桌面生成应用图标 -->
    <intent-filter>
      <action android:name="android.intent.action.MAIN"/>
      <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
  </activity>
  <!-- 其余Activity声明 -->
  ...
</application>
...

异常复现场景 #

用户在WelcomeScreenActivity点击"退出登录"按钮时，会清除本地登录状态，停留在当前页展示登出提示图，实现代码如下：

class WelcomeScreenActivity : AppCompatActivity() {
  fun onLogoutClicked() {
    // 清除登录状态并展示登出提示图
    val prefs = PreferenceManager.getDefaultSharedPreferences(this)
    prefs.edit().putBoolean("USER_IS_LOGGED_IN", false).apply()
    showLoggedOutImage()
  }
}

此时用户按返回键会退出应用，因为返回栈中仅剩WelcomeScreenActivity。

Android 12+ 异常表现 #

在Android 12及更高版本中，用户退出后点击应用图标重新启动时，仅会触发LoginActivity.onResume()，展示错误页面。
该问题源于Android 12/13的Activity生命周期行为变更：系统修改了任务栈根位置启动Activity的返回键默认处理逻辑，旧版本系统在用户按返回键时会销毁根Activity，Android 12及以上版本会将Activity连同整个任务栈移至后台，而非销毁，行为和按Home键/手势退到桌面一致，因此重新启动时不会调用LoginActivity.onCreate()，无法执行登录状态判断、展示登录表单。 #

问题解答 #

目标是实现兼容所有Android版本的根启动逻辑，重启应用时可正确触发状态判断、展示对应页面，三个问题的结论如下：

• 关于「是否可以将onCreate()中的启动判断逻辑迁移至onResume()或onNewIntent()，有无副作用」
  可以迁移，但不能直接全量搬运，必须加防重入标记，否则会出现重复跳转、生命周期死循环问题。
  • onNewIntent()仅在Activity配置了singleTop/singleTask启动模式、且栈顶已存在该Activity实例时才会触发，默认启动模式下不会走该回调，单独把判断逻辑放这里覆盖不到场景。
  • 直接把跳转逻辑无限制放在onResume()中，每次页面切前台（比如授权弹窗返回、通知栏收起、跳转其他页面再返回）都会重复执行判断，可能出现反复跳转欢迎页、页面闪烁的问题。
• 关于「是否需要在onResume()中判断系统版本，对Android 12及以上版本做专属兼容处理」
  不需要。
  统一的路由判断逻辑可以全版本通用，单独加版本判断只会增加后续维护成本，若后续Android版本再次调整生命周期逻辑还要额外适配，属于冗余代码。
• 关于「Android 12上是否存在配置方式，可强制按返回键退出后重启应用时调用LoginActivity.onCreate()」
  没有可直接配置的Manifest参数能关闭该系统默认行为。
  网传给根Activity加android:excludeFromRecents="true"的方案会导致应用不在最近任务列表显示，严重破坏用户体验，不建议使用。重写onBackPressed()调用finishAndRemoveTask()的方式，仅能覆盖用户主动按返回键退出的场景，无法覆盖Home键切后台、系统内存回收等场景，适配不全面。

最终推荐实现 #

抽离统一的登录状态路由判断方法，加防重入标记位，在onCreate()和onResume()中都调用即可，代码量小、全版本兼容、无副作用，不需要做版本适配，也不需要修改Manifest配置，参考代码如下：

/** 应用图标点击后的主入口Activity */
class LoginActivity : AppCompatActivity() {
    // 防重入标记，保证路由判断单次执行
    private var hasRouteChecked = false

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        checkLoginAndRoute()
    }

    override fun onResume() {
        super.onResume()
        checkLoginAndRoute()
    }

    /**
     * 统一检查登录状态，执行对应路由跳转
     */
    private fun checkLoginAndRoute() {
        if (hasRouteChecked) return
        val prefs = PreferenceManager.getDefaultSharedPreferences(this)
        val isLoggedIn = prefs.getBoolean("USER_IS_LOGGED_IN", false)
        hasRouteChecked = true
        if (isLoggedIn) {
            launchWelcomeScreenActivity()
            finish()
        } else {
            displayLoginFields()
        }
    }

    // 其余业务逻辑
}

内容的提问来源于stack exchange，提问作者Mr-IDE