AndroidManifest中Unresolved class 'MainActivity'问题排查求助

以下是适配当前Android开发环境的排查步骤，覆盖Manifest配置、代码结构、Gradle设置等核心环节：

一、检查AndroidManifest.xml配置 #

• 确保MainActivity的全类名拼写准确，相对包名需与实际项目包结构匹配：

  <activity
      android:name=".MainActivity"
      android:exported="true">
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
  </activity>
  

• 多模块项目需指定完整包路径，例如com.example.myapp.MainActivity
• API 31及以上版本必须正确配置android:exported属性

二、验证MainActivity.kt代码结构 #

• 确保类未被internal修饰（Kotlin默认public，无需显式声明）
• 继承关系符合规范，示例：

  package com.example.myapp
  
  import androidx.appcompat.app.AppCompatActivity
  import android.os.Bundle
  
  class MainActivity : AppCompatActivity() {
      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
          setContentView(R.layout.activity_main)
      }
  }
  

• 确认文件顶部的package声明与Manifest中package属性完全一致

三、检查Gradle配置 #

模块级build.gradle.kts（或build.gradle） #

• 确保kotlin-android插件已正确应用：

  plugins {
      id("com.android.application")
      id("org.jetbrains.kotlin.android")
  }
  

• 验证compileSdk、targetSdk版本与依赖库兼容，避免版本不匹配导致的识别异常

项目级build.gradle.kts #

• 确认Android Gradle插件与Kotlin版本兼容，示例匹配版本：

  plugins {
      id("com.android.application") version "8.2.0" apply false
      id("org.jetbrains.kotlin.android") version "1.9.20" apply false
  }
  

四、清理重建项目 #

• 执行Android Studio菜单：File > Invalidate Caches... > Invalidate and Restart
• 终端执行命令清理构建缓存：

  ./gradlew clean assembleDebug
  

若以上步骤未解决问题，请补充：

• 错误截图中的具体报错文本
• MainActivity.kt的完整代码内容
• 模块级build.gradle的完整配置

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