如何排查Android Studio中QRCodeReaderView无法导入的问题

问题场景 #

我想要实现一个包含二维码扫描视图、spinner和按钮的Activity，效果如下图：

首先使用QRCodeReaderView实现了独立测试应用，功能正常：相机对准二维码后会弹出Toast展示其内容。将代码迁移到正式项目时出现以下问题：
编辑build.gradle添加了如下依赖行：

implementation "com.dlazaro66.qrcodereaderview:qrcodereaderview:2.0.3"

随后Android Studio提示错误：

布局文件中引用的类com.dlazaro66.qrcodereaderview.QRCodeReaderView在项目或依赖库中未找到

Android Studio自动导入功能无法识别该类，尝试重建项目、执行Invalidate Caches / Restart、重新同步项目均未解决。
开发环境为Android Studio Arctic Fox 2020.3.1 Patch 3，测试应用和正式项目配置参数一致：

• compileSdk 31
• minSdk 23
• targetSdk 31
• kotlin 1.6.0
• jvmTarget 1.8

排查建议 #

1. 检查依赖添加位置：确认你是在模块级别的build.gradle（一般是app目录下的build.gradle）中添加的依赖，而非项目根目录的build.gradle。
2. 检查maven仓库配置：该依赖托管在JCenter，现在很多新项目默认移除了JCenter源，你需要在项目根目录的settings.gradle（旧版本是根目录build.gradle的allprojects→repositories块）中添加JCenter配置：

repositories {
    // 其他原有仓库配置保留，新增下面这行
    jcenter()
}

添加完成后重新同步Gradle即可。
3. 排查依赖冲突：如果添加JCenter后仍无法识别，执行Gradle命令./gradlew app:dependencies（Windows环境执行gradlew app:dependencies）查看依赖树，确认QRCodeReaderView相关依赖是否被排除或者拉取失败。
4. 离线缓存排查：如果开启了Gradle离线模式，先关闭离线模式后再重新同步，避免本地缓存缺失对应版本的依赖包。
5. 备选方案：如果JCenter无法访问，可以直接将该库的核心代码拷贝到你的项目中直接使用，无需远程依赖。

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