Flutter添加youtube_player_iframe依赖后构建报错如何解决

云原生阿岚

2026-9-26

修复方案

该错误是Gradle无法正常访问Maven中央仓库拉取依赖包导致的，可按以下步骤逐一排查修复：

替换Maven镜像源
打开项目android/build.gradle文件，分别修改buildscript和allprojects块下的repositories配置，将默认的google()、mavenCentral()替换为国内阿里云镜像，修改后配置参考：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/maven-central' }
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/maven-central' }
    }
}

检查网络与DNS配置
先测试是否能正常访问repo.maven.apache.org，如果访问失败可将本地DNS改为公共DNS，比如114.114.114.114或者8.8.8.8，修改完成后刷新本地DNS缓存再尝试构建。如果本地使用了代理，需要检查android/gradle.properties中的代理配置是否正确，未使用代理则删除该文件中所有proxy相关的配置项。
清理缓存后重新构建
依次执行以下命令清理缓存后重新运行项目：
```
flutter clean
```
手动删除项目根目录下android/.gradle文件夹，再执行：
```
flutter pub get
```
完成后重新启动项目即可。
排查依赖版本兼容性
如果以上操作都无效，可检查pubspec.yaml中依赖的版本兼容性：你当前使用的youtube_player_iframe: ^2.2.2可能和项目中的flutter_local_notifications版本存在冲突，可尝试将两个依赖升级到最新稳定版，或者指定互相兼容的版本号再重新拉取依赖。