React Native安卓导入Kotlin包报cannot find symbol如何修复

开发React Native应用时集成react-native-vision-camera库，按照官方安卓帧处理器插件开发指南编写Kotlin原生代码，实现逐帧处理相机流的自定义帧处理器插件，多次构建安装应用均抛出Kotlin/Java编译错误。
所有相关文件存放路径为.../android/app/src/main/java/com/rncamera0，包含3个文件：

• MainApplication.java
• BasicFrameProcessorPlugin.kt
• BasicFrameProcessorPluginPackage.kt
  三个文件首行均已声明package com.rncamera0，编译时提示无法找到BasicFrameProcessorPluginPackage类。

error Failed to install the app. Make sure you have the Android development environment set up.
Error: Command failed: ./gradlew app:installDebug -PreactNativeDevServerPort=8081
Warning: unexpected element (uri:"", local:"base-extension"). Expected elements are <{}codename>,<{}layoutlib>,<{}api-level>
/home/luciano/wildsense/nam-vital-signs/rn/RNCamera0/android/app/src/main/java/com/rncamera0/MainApplication.java:16: error: cannot find symbol
import com.rncamera0.BasicFrameProcessorPluginPackage;
                    ^
  symbol:   class BasicFrameProcessorPluginPackage
  location: package com.rncamera0
/home/luciano/wildsense/nam-vital-signs/rn/RNCamera0/android/app/src/main/java/com/rncamera0/MainApplication.java:33: error: cannot find symbol
          packages.add(new BasicFrameProcessorPluginPackage());
                           ^
  symbol: class BasicFrameProcessorPluginPackage
Note: /home/luciano/wildsense/nam-vital-signs/rn/RNCamera0/android/app/src/debug/java/com/rncamera0/ReactNativeFlipper.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
2 errors

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:compileDebugJavaWithJavac'.

核心原因是安卓项目未启用Kotlin编译支持：当前构建流程仅执行Java代码编译任务，不会识别、编译同目录下的.kt后缀Kotlin文件，因此Java代码引用Kotlin编写的类时会提示找不到符号。
日志中unexpected element (uri:"", local:"base-extension")为Android SDK版本兼容警告，和本次编译失败无关，可忽略。

按以下步骤逐一配置修复：

• 第一步：配置项目级Gradle添加Kotlin插件依赖
  打开android/build.gradle文件，在buildscript配置块中添加Kotlin Gradle插件依赖，Kotlin版本和当前项目使用的React Native版本对齐即可，参考配置：

buildscript {
    ext {
        buildToolsVersion = "33.0.0"
        minSdkVersion = 21
        compileSdkVersion = 33
        targetSdkVersion = 33
        // 新增Kotlin版本声明，可根据项目实际情况选择1.7.x/1.8.x等稳定版本
        kotlinVersion = "1.8.0"
    }
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:7.3.1")
        classpath("com.facebook.react:react-native-gradle-plugin")
        // 新增Kotlin插件依赖
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")
    }
}

• 第二步：配置App模块启用Kotlin编译
  打开android/app/build.gradle文件，在顶部插件声明块中添加Kotlin安卓插件：

plugins {
    id "com.android.application"
    id "com.facebook.react"
    // 新增Kotlin插件声明
    id "org.jetbrains.kotlin.android"
}

如果是老版本Gradle使用apply plugin写法，直接添加apply plugin: 'org.jetbrains.kotlin.android'即可。

• 第三步：校验Kotlin类实现正确性
  确认两个Kotlin文件的类声明为公开可访问（不要加internal/private修饰符），且文件名和类名大小写完全匹配：
  1. BasicFrameProcessorPlugin.kt中类需正确继承FrameProcessorPlugin基类
  2. BasicFrameProcessorPluginPackage.kt中类需正确实现ReactPackage接口，不要出现拼写错误，参考正确结构：

package com.rncamera0

import com.facebook.react.ReactPackage
import com.facebook.react.bridge.NativeModule
import com.facebook.react.bridge.ReactApplicationContext
import com.facebook.react.uimanager.ViewManager
import com.mrousavy.camera.frameprocessor.FrameProcessorPlugin

class BasicFrameProcessorPluginPackage : ReactPackage {
    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
        return emptyList()
    }

    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
        return emptyList()
    }

    init {
        // 注册自定义帧处理器插件
        FrameProcessorPlugin.registerPlugin(BasicFrameProcessorPlugin())
    }
}

• 第四步：清理构建缓存重新编译
  在项目根目录执行以下命令清理缓存后重新构建：

cd android
./gradlew clean
cd ..
npx react-native run-android

如果完成上述配置后仍报错，检查两点：

• 确认文件存放路径完全匹配包名：包名为com.rncamera0时，文件必须存放在android/app/src/main/java/com/rncamera0目录下，不要放错层级
• 确认Kotlin类没有被非公开修饰符修饰，否则Java代码无法访问该类

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