Flutter添加shared_preferences包时出现lintClassPath配置解析失败错误

云上老周

2026-10-3

解决方案

问题根因

该报错是低版本项目配置和新版shared_preferences依赖的构建要求不匹配，加上JCenter镜像停服导致部分依赖包无法拉取导致。

操作步骤

第一步：修改android/build.gradle配置
升级Kotlin版本、Gradle插件版本，替换JCenter为MavenCentral，修改后内容如下：

buildscript {
    ext.kotlin_version = '1.6.21'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.4'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
    project.evaluationDependsOn(':app')
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

第二步：修改android/gradle/wrapper/gradle-wrapper.properties配置
将distributionUrl改为和Gradle插件匹配的版本：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-all.zip
```
第三步：指定shared_preferences兼容版本
由于你使用的Flutter 2.5.1版本较旧，不要使用最新版的shared_preferences，在pubspec.yaml中指定适配版本：
```
dependencies:
  shared_preferences: 2.0.15
```
第四步：重新构建项目
依次执行以下命令：
```
flutter clean
flutter pub get
```
之后再正常启动项目即可。