Android项目终端执行Gradle lint报错：找不到Context等符号

针对你遇到的Java+Kotlin混合Android项目在Android Studio里运行构建都正常，但终端执行Lint任务时出现大量cannot find symbol错误（比如Context、CognitoUserSession这类类都找不到）的问题，我整理了几个实用的排查和解决方法：

1. 先完成编译再执行Lint #

Lint任务默认不会自动依赖编译流程，而Android Studio运行时会先完成编译，所以终端里可以先执行编译再跑Lint：

./gradlew :app:compileDebugSources :app:lintDebug

如果不想每次都手动敲两条命令，也可以在app模块的build.gradle里让Lint自动依赖编译任务：

lint.dependsOn compileDebugSources

这样每次执行Lint前都会先完成编译，确保所有类文件都已生成。

2. 检查Kotlin与Java的交互配置 #

混合项目里Kotlin和Java的兼容性配置很关键，先确认项目根目录的build.gradle里Kotlin插件和版本配置正确：

buildscript {
    ext.kotlin_version = "你的项目Kotlin版本"
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

再检查app模块的build.gradle里同时应用了Java和Kotlin插件：

plugins {
    id 'com.android.application'
    id 'kotlin-android'
}

另外，确保Kotlin源码目录被正确识别，在app模块的android块里添加：

sourceSets {
    main.java.srcDirs += 'src/main/kotlin'
}

3. 清理Gradle缓存 #

缓存损坏是这类问题的常见诱因，执行以下命令清理缓存后重新构建：

./gradlew clean build --no-build-cache

也可以手动删除项目根目录的.gradle文件夹和app/build文件夹，再重新执行Lint任务。

4. 检查第三方依赖的Scope #

如果像Cognito这类第三方依赖用了compileOnly的scope，Lint任务的类路径里会找不到这些类。把依赖改成implementation：

implementation 'com.amazonaws:aws-android-sdk-cognito:你的依赖版本'

如果确实需要用compileOnly，可以在app模块的build.gradle里把编译类路径添加到Lint的类路径中：

lintClasspath += configurations.compileClasspath

5. 指定Lint的构建变体 #

如果项目有多个构建变体（比如debug/release），可能需要明确指定Lint针对哪个变体执行，避免变体依赖缺失导致错误：

./gradlew :app:lintDebug

也可以在app模块的build.gradle里配置默认的Lint变体：

android {
    lint {
        variantFilter { variant ->
            variant.name == 'debug'
        }
    }
}

你可以先从清理缓存、先编译再跑Lint这两个方法试起，这是解决这类问题最常用的方向。

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