Android Studio中detekt.yml Schema验证不兼容警告如何修复？

我在Android Studio Dolphin | 2021.3.1 Patch 1版本中遇到了detekt.yml文件的Schema验证不兼容警告，希望找到解决该警告的方法。以下是可复现问题的最小化detekt.yml配置文件：

build:
  maxIssues: 0
  excludeCorrectable: false
  weights:
     complexity: 2
     LongParameterList: 1
     style: 1
     comments: 1

config:
  validation: true
  warningsAsErrors: true
  # when writing own rules with new properties, exclude the property path e.g.: 'my_rule_set,.*>.*>[my_property]'
  excludes: ''

processors:
  active: true
  exclude:
    - 'DetektProgressListener'
  # - 'KtFileCountProcessor'
  # - 'PackageCountProcessor'
  # - 'ClassCountProcessor'
  # - 'FunctionCountProcessor'
  # - 'PropertyCountProcessor'
  # - 'ProjectComplexityProcessor'
  # - 'ProjectCognitiveComplexityProcessor'
  # - 'ProjectLLOCProcessor'
  # - 'ProjectCLOCProcessor'
  # - 'ProjectLOCProcessor'
  # - 'ProjectSLOCProcessor'
  # - 'LicenseHeaderLoaderExtension'

style:
  active: true
  ReturnCount:
    active: true
    max: 2
    excludedFunctions: 'equals'
    excludeLabeled: false
    excludeReturnFromLambda: true
    excludeGuardClauses: true

Android Studio版本详情：

• 版本：Dolphin | 2021.3.1 Patch 1
• Build编号：AI-213.7172.25.2113.9123335（构建于2022年9月30日）
• 运行时版本：11.0.13+0-b1751.21-8125866 x86_64
• 虚拟机：JetBrains s.r.o.的OpenJDK 64-Bit Server VM

可行的解决方法 #

1. 对齐detekt插件版本 #

detekt的Schema会随版本迭代更新，必须保证项目依赖的detekt Gradle插件版本和Android Studio中安装的detekt IDE插件版本完全一致：

• 查看项目根目录build.gradle中的detekt版本：

plugins {
    id("io.gitlab.arturbosch.detekt") version "x.y.z"
}

• 打开Android Studio插件市场，确认detekt插件版本，修改Gradle配置中的版本号后同步项目，重新验证。

2. 临时关闭Schema验证 #

如果暂时无法处理版本兼容问题，可以关闭detekt的配置验证功能，修改detekt.yml中的config.validation为false：

config:
  validation: false
  warningsAsErrors: true
  excludes: ''

注意：这只是临时方案，长期使用会错过配置错误提示，建议优先解决版本匹配问题。

3. 同步配置到对应版本的Schema规范 #

不同版本的detekt对配置项的要求可能有变化，比如规则参数、权重配置的位置等。可以参考当前使用的detekt版本官方文档，逐一检查配置文件中的项是否符合规范，比如build.weights中直接指定单个规则的权重，部分版本可能要求通过规则集层级配置。

4. 生成默认配置文件参考 #

使用detekt命令生成当前版本的默认配置文件，对比自己的配置进行修正：
在项目终端执行：

./gradlew detektGenerateConfig

生成的配置文件会包含当前版本所有合法的配置项和默认值，你可以以此为模板，迁移自己的规则配置，移除或修改不兼容的内容。

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