Android Studio Dolphin无法检测自定义Lint规则问题求助

问题背景 #

我通过以下方式在项目中引入自定义Linter：

dependencies {
    implementation("cz.thorovsky.android.mylint:mylint-lint:1.23")
}

该配置在Android Studio Dolphin版本前运行正常，但升级后出现以下问题：

• 通过Code -> Inspect code操作无法执行自定义Lint检查，检查项中不显示该Linter
• 通过Code -> Analyze Code -> Run Inspection by Name对话框指定其ID也无法找到
• Gradle同步后该Linter显示在外部库中，控制台执行./gradlew lint时运行完全正常

环境信息 #

• Gradle版本：7.5.1
• AGP版本：7.1.0-rc01

已尝试的排查操作 #

• 引入并运行其他自定义Linter，可正常工作
• 升级Android Studio至Electric Eel 2022.1.1 rc3，问题仍存在
• 更换全新机器（清理Gradle缓存、全新安装AS、重新克隆项目），问题依旧
• 尝试改用Gradle的lintChecks配置，无效

疑问 #

1. 为什么旧版AS中可以正常工作？
2. 为什么其他Linter可以正常运行？
3. 为什么控制台执行时能正常工作？

可能的原因及解决方案 #

1. Lint库未适配AS新版本的Lint API #

Android Studio Dolphin及后续版本升级了内置的Lint引擎，你的自定义Lint库mylint-lint:1.23大概率没适配新版本的Lint API。

• 控制台./gradlew lint用的是AGP自带的Lint版本（和AGP 7.1.0匹配），而IDE内的Lint用的是AS独立内置的高版本Lint引擎，两者API存在差异，导致IDE识别不了你的自定义规则。
• 其他能正常运行的Lint库应该已经适配了新API，所以不受影响；旧版AS的内置Lint引擎版本和AGP 7.1.0匹配，所以之前能正常工作。

解决办法：

• 查看该自定义Lint库的更新记录，升级到适配AS Dolphin及以上版本的最新版
• 如果是自己开发的Lint库，同步升级Lint依赖版本，对齐AS新版本的Lint API（比如使用com.android.tools.lint:lint-api:7.2+或更高版本）

2. IDE未正确加载自定义规则的注册信息 #

虽然Gradle同步后库显示在外部库中，但IDE可能没正确扫描到Lint规则的注册信息。部分旧版Lint库的规则注册方式（比如通过META-INF/services）在新版本IDE的类加载机制下可能失效。

解决办法：

• 检查自定义Lint库的规则注册逻辑：确保使用@LintDetector注解，且通过lint.xml或代码完成规则注册
• 在项目根目录的lint.xml中显式启用该Lint规则，示例：

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <issue id="你的Lint规则ID" severity="warning" />
</lint>

• 清理IDE缓存：通过File -> Invalidate Caches... -> Invalidate and Restart操作，重启后重新同步Gradle

3. AGP版本与AS版本不匹配 #

你用的AGP是7.1.0-rc01，而AS Dolphin对应AGP 7.2.x，Electric Eel对应AGP 7.3.x，版本不匹配会导致IDE的Lint引擎和AGP的Lint环境不一致，无法识别自定义规则。

解决办法：
将AGP版本升级到与当前AS版本匹配的稳定版，比如AS Dolphin对应AGP 7.2.2，Electric Eel对应AGP 7.3.1，升级后重新同步Gradle

内容的提问来源于stack exchange，提问作者Tomáš Hořovský