Android Studio自定义Lint迁移后失效排查求助

以下是针对你遇到的问题的具体排查方向和解决方案：

1. 检查Lint API版本与AGP兼容性 #

你当前使用的lint-api:30.1.0-alpha03是早期预览版本，和多数现代AGP版本（7.x/8.x）存在兼容性问题，会导致Lint无法正确加载自定义规则。

解决方法：
将Lint依赖版本替换为与目标项目AGP匹配的稳定版本：

• AGP 7.0.x → com.android.tools.lint:lint-api:7.0.4
• AGP 7.4.x → com.android.tools.lint:lint-api:7.4.2
• AGP 8.0.x → com.android.tools.lint:lint-api:8.0.2
• AGP 8.2.x → com.android.tools.lint:lint-api:8.2.1

修改lint模块的build.gradle.kts：

dependencies {
    compileOnly("com.android.tools.lint:lint-api:8.2.1") // 替换为对应AGP版本的lint-api
    testImplementation("com.android.tools.lint:lint-tests:8.2.1")
    testImplementation("junit:junit:4.13.2")
}

2. 修正Detector的接口实现 #

你的AndroidEntryPointDetector实现了XmlScanner，但实际是基于UAST处理Java/Kotlin类的规则，应该实现UastScanner接口（使用UAST API的Detector标准接口），否则Lint可能无法识别该Detector的扫描类型，导致规则不触发。

修改代码：

class AndroidEntryPointDetector : Detector(), UastScanner { // 替换XmlScanner为UastScanner
    override fun getApplicableUastTypes(): List<Class<out UElement>> =
        listOf(UClass::class.java)

    override fun createUastHandler(context: JavaContext): UElementHandler =
        AndroidEntryPointVisitor(context)
}

3. 验证Manifest中的Registry路径正确性 #

确认Lint-Registry-v3指定的类路径in.lint.CustomLintRegistry与实际类的包名、类名完全一致：

• 检查CustomLintRegistry的包名是否确实是in.lint
• 类名是否拼写正确（大小写敏感）

如果包名或类名有误，Lint无法找到注册表，自然加载不了规则。

4. 排查目标项目的Lint配置是否屏蔽规则 #

检查目标项目各模块的lintOptions，确认没有设置以下会屏蔽自定义规则的配置：

lintOptions {
    // 禁止只检查指定规则，会排除自定义规则
    // checkOnly 'NewApi', 'ValidFragment'
    // 禁止直接禁用你的规则
    // disable 'AndroidEntryPointImplementationIssue'
    // 禁止忽略警告（你的规则是WARNING级别）
    // ignoreWarnings true
}

5. 彻底清理缓存并重新构建 #

除了Android Studio的缓存，执行以下操作彻底清理Gradle缓存：

1. 执行终端命令：./gradlew clean cleanBuildCache
2. 删除项目根目录下的.gradle文件夹（会重新下载依赖，耗时较长）
3. 重启Android Studio，执行File -> Invalidate Caches...并勾选Clear file system cache and local history，重启后重新构建项目

6. 验证自定义规则是否能被Lint命令识别 #

在终端执行./gradlew lint，查看输出日志：

• 搜索你的规则IDAndroidEntryPointImplementationIssue，看是否有相关加载或扫描日志
• 如果出现Could not find lint registry class等错误，说明Registry路径错误
• 如果没有任何相关日志，说明规则未被加载，回到前面的步骤排查

7. 检查Android Studio的Inspection配置 #

打开Settings -> Editor -> Inspections：

• 直接搜索规则IDAndroidEntryPointImplementationIssue，确认是否被禁用
• 如果找不到，检查Custom分类（自定义规则默认在这里）或Correctness分类（你的规则设置的Category）

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