Gradle项目接入Firestore遇ClassNotFoundException问题求助

我之前在AWS Lambda上部署Firebase Admin项目时，也碰到过完全一样的com.google.auth.oauth2.GoogleCredentials和com.google.api.client.googleapis.util.Utils找不到的问题，折腾了好一阵才搞定。结合你的情况（Gradle项目、Firebase Admin 6.0.0），给你几个针对性的解决方案：

1. 确认依赖版本兼容性并显式引入缺失包 #

Firebase Admin 6.0.0的依赖链里，部分核心依赖是可选传递的，Gradle默认可能不会自动引入，而且手动加错版本还会导致冲突。你需要在build.gradle里显式指定和6.0.0兼容的依赖版本：

plugins {
    id 'java'
    // 用shadow插件打包含所有依赖的Fat Jar，Lambda必须用这种包
    id 'com.github.johnrengelman.shadow' version '7.1.2'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.google.firebase:firebase-admin:6.0.0'
    // 显式引入缺失的核心依赖，版本和firebase-admin 6.0.0严格匹配
    implementation 'com.google.auth:google-auth-library-oauth2-http:0.26.0'
    implementation 'com.google.api-client:google-api-client:1.34.1'
}

// 强制依赖版本，避免Lambda环境自带的旧版本冲突
configurations.all {
    resolutionStrategy.force 'com.google.auth:google-auth-library-oauth2-http:0.26.0'
    resolutionStrategy.force 'com.google.api-client:google-api-client:1.34.1'
}

2. 修正打包配置，确保所有依赖被包含 #

AWS Lambda不会自动帮你拉取依赖，必须把所有runtime依赖打包到同一个Jar里（也就是Fat Jar）。普通的jar任务生成的包只包含你的代码，不会带依赖，所以一定要用shadowJar任务构建：

• 在IntelliJ里，打开Gradle面板，找到Tasks > shadow > shadowJar，运行这个任务生成Fat Jar
• 部署时，上传这个build/libs/[your-project]-all.jar文件，而不是普通的[your-project].jar

另外，在shadowJar配置里可以排除Lambda环境已经自带的依赖（比如AWS SDK相关），避免包体积过大和冲突：

shadowJar {
    mergeServiceFiles()
    // 排除Lambda内置的AWS依赖，按需调整
    exclude 'com.amazonaws:*'
}

3. 检查初始化代码的类路径 #

有时候代码里不小心引入了错误的GoogleCredentials类（比如来自其他oauth库），要确保初始化代码里用的是Firebase Admin依赖的类：

import com.google.auth.oauth2.GoogleCredentials;
import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;

// 正确的初始化方式
FirebaseOptions options = FirebaseOptions.builder()
    .setCredentials(GoogleCredentials.fromStream(getClass().getResourceAsStream("/serviceAccountKey.json")))
    .setDatabaseUrl("https://your-project-id.firebaseio.com")
    .build();

// 避免重复初始化
if (FirebaseApp.getApps().isEmpty()) {
    FirebaseApp.initializeApp(options);
}

4. 排查Lambda环境的依赖冲突 #

AWS Lambda的运行环境自带了一些Google相关的旧版本依赖，可能和你的Firebase Admin依赖版本冲突。可以通过以下方式验证：

• 本地用Lambda模拟环境（比如SAM CLI）运行，看是否能复现问题
• 如果本地没问题，部署时在Lambda的"层"（Layer）里单独放置Firebase Admin的依赖，避免和内置依赖冲突

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