本文详解如何在 Android Java 项目中基于 CameraX 和 ML Kit 实现高性能条码扫描，并彻底解决因 Kotlin 标准库版本冲突导致的 Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt 编译错误。
本文详解如何在 android java 项目中基于 camerax 和 ml kit 实现高性能条码扫描，并彻底解决因 kotlin 标准库版本冲突导致的 `duplicate class kotlin.collections.jdk8.collectionsjdk8kt` 编译错误。
在 Android 开发中，使用 CameraX 搭配 Google ML Kit 进行条码（含 QR 码、EAN、Code128 等）扫描是当前推荐的现代化方案——它比传统 ZXing 的 SurfaceView + PreviewCallback 方式更稳定、更轻量，且天然支持生命周期感知与多设备适配。然而，许多 Java 开发者在集成过程中会遇到编译期冲突，典型如：
Duplicate class kotlin.collections.jdk8.CollectionsJDK8Kt found in modules jetified-kotlin-stdlib-1.8.0 and jetified-kotlin-stdlib-jdk8-1.6.0
该错误本质是 Kotlin 标准库版本不一致引发的重复类加载：kotlin-stdlib-jdk8 是 kotlin-stdlib 的子模块（自 Kotlin 1.7+ 起已废弃并合并入主库），而某些旧版依赖（如早期 ML Kit 或第三方库）仍显式引入了 kotlin-stdlib-jdk8，与新版本 kotlin-stdlib（如 1.8.0）发生类路径重叠。
✅ 根本解决方案（Gradle 配置）：
在 app/build.gradle 中强制统一 Kotlin 标准库版本，并排除冗余传递依赖：
android {
compileSdk 34
// 确保 Kotlin 插件版本与 stdlib 匹配（建议 1.8.0+）
kotlinOptions {
jvmTarget = "1.8"
}
}
dependencies {
// CameraX 核心（Java 友好，无需 Kotlin DSL）
def camerax_version = "1.3.0"
implementation "androidx.camera:camera-core:${camerax_version}"
implementation "androidx.camera:camera-camera2:${camerax_version}"
implementation "androidx.camera:camera-lifecycle:${camerax_version}"
implementation "androidx.camera:camera-view:1.3.0" // 替代 PreviewView 的现代化组件
// ML Kit 条码扫描（官方 Java 支持完备）
implementation 'com.google.mlkit:barcode-scanning:18.4.0'
// 关键：排除过时的 kotlin-stdlib-jdk8 传递依赖
implementation('com.google.mlkit:barcode-scanning:18.4.0') {
exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk8'
}
implementation('androidx.camera:camera-view:1.3.0') {
exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk8'
}
// 显式声明统一的 Kotlin 标准库（可选但强烈推荐）
implementation 'org.jetbrains.kotlin:kotlin-stdlib:1.8.0'
}同时，在项目根目录 build.gradle（或 settings.gradle）中确认 Kotlin 插件版本：
plugins {
id 'org.jetbrains.kotlin.android' version '1.8.0' apply false
}? Java 代码集成要点（CameraX + ML Kit）：
以下为关键流程精简示例（无 Kotlin 语法，纯 Java）：
// 1. 初始化 BarcodeScanner（一次创建，复用）
BarcodeScanner scanner = BarcodeScanning.getClient(
new BarcodeScannerOptions.Builder()
.setBarcodeFormats(Barcode.FORMAT_QR_CODE, Barcode.FORMAT_EAN_13)
.build()
);
// 2. 绑定 LifecycleOwner（如 Activity/Fragment）
Preview preview = new Preview.Builder().build();
ImageAnalysis analysis = new ImageAnalysis.Builder()
.setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST)
.build();
analysis.setAnalyzer(ContextCompat.getMainExecutor(this), image -> {
InputImage inputImage = InputImage.fromMediaImage(
image.getImage(), image.getImageInfo().getRotationDegrees()
);
scanner.process(inputImage)
.addOnSuccessListener(barcodes -> {
for (Barcode barcode : barcodes) {
String rawValue = barcode.getRawValue();
Log.d("Barcode", "Detected: " + rawValue);
// ✅ 在主线程更新 UI（如 TextView.setText(rawValue)）
}
})
.addOnFailureListener(e -> Log.e("Barcode", "Scan failed", e))
.addOnCompleteListener(() -> image.close()); // 必须释放图像
});
// 3. 绑定到 PreviewView（XML 中定义 android:id="@+id/viewFinder"）
PreviewView viewFinder = findViewById(R.id.viewFinder);
preview.setSurfaceProvider(viewFinder.getSurfaceProvider());
analysis.setSurfaceProvider(viewFinder.getSurfaceProvider());
// 4. 启动相机（需在 LifecycleScope 内，如 onCreate 后）
ListenableFuture<ProcessCameraProvider> cameraProviderFuture =
ProcessCameraProvider.getInstance(this);
cameraProviderFuture.addListener(() -> {
try {
ProcessCameraProvider cameraProvider = cameraProviderFuture.get();
cameraProvider.unbindAll();
cameraProvider.bindToLifecycle(this, CameraSelector.DEFAULT_BACK_CAMERA,
preview, analysis);
} catch (ExecutionException | InterruptedException e) {
Log.e("CameraX", "Use case binding failed", e);
}
}, ContextCompat.getMainExecutor(this));? 重要注意事项：
立即学习“Java免费学习笔记（深入）”；
-
权限声明：确保 AndroidManifest.xml 中添加
，并在运行时动态申请； - 线程安全：ImageAnalysis.Analyzer 回调在后台线程执行，所有 UI 操作必须切回主线程（如 runOnUiThread() 或 Handler(Looper.getMainLooper())）；
- 资源释放：务必调用 image.close()，否则会导致内存泄漏与预览卡顿；
- Java 文档参考：官方 CameraX Java API 文档位于 developer.android.com/reference/androidx/camera；实战向 Java 教程推荐 LearnToDroid 的 QR 扫描教程（全程 Java，含完整源码）；
- 替代方案提示：若坚持使用 ZXing，建议改用 com.journeyapps:zxing-android-embedded:4.3.0（已适配 AndroidX），但其性能与兼容性仍弱于 ML Kit + CameraX 组合。
综上，通过精准的依赖管理 + 规范的 Java API 调用，你完全可以构建一个零 Kotlin 侵入、高稳定性、全功能的条码扫描应用。核心在于：统一 Kotlin 版本、排除冗余模块、遵循 CameraX 生命周期绑定规范、善用 ML Kit 的异步处理模型。
