App Engine标准Java中Firebase Admin初始化失败：Guava版本冲突

我之前在App Engine标准环境里集成Firebase Auth时也碰到过一模一样的问题！你猜的没错，就是Guava版本冲突导致的，而且这个坑在App Engine里特别容易踩——因为App Engine本身内置了一个旧版本的Guava，会覆盖你自己打包的版本。

问题根源 #

Firebase Admin SDK 5.7.0依赖的Guava版本需要com.google.common.base.Preconditions.checkState(ZLjava/lang/String;Ljava/lang/Object;)V这个重载方法，但App Engine标准环境默认内置的Guava版本（比如19.0）没有这个方法，所以初始化时就会抛出NoSuchMethodError。哪怕你在Gradle里排除了firebase-admin自带的Guava，App Engine还是会优先加载它内置的旧版本。

解决方案 #

需要两步操作来彻底解决这个问题：

1. 确认Gradle依赖配置（你已做的配置是正确的，继续保持） #

你的Gradle配置已经排除了firebase-admin的Guava并引入了23.0版本，这个逻辑没问题：

dependencies {
    appengineSdk 'com.google.appengine:appengine-java-sdk:1.9.60'
    compile 'com.google.appengine.tools:appengine-gcs-client:0.7'
    compile ('com.google.firebase:firebase-admin:5.7.0') {
        exclude group: 'com.google.guava'
    }
    compile 'com.google.guava:guava:23.0'
    compile 'javax.servlet:servlet-api:2.5'
}

2. 配置App Engine类加载优先级 #

在appengine-web.xml文件中添加类加载规则，强制App Engine优先使用你打包在WEB-INF/lib里的Guava jar，而不是内置的旧版本：

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
    <!-- 保留你原有的其他配置，比如application、version等 -->
    
    <class-loader-config>
        <priority-specifier filename="guava-23.0.jar"/>
    </class-loader-config>
</appengine-web-app>

3. 优化Firebase初始化代码（可选但建议） #

为了避免重复初始化FirebaseApp导致的异常，建议在初始化前先检查是否已有实例：

// 检查是否已经初始化过FirebaseApp
if (FirebaseApp.getApps().isEmpty()) {
    InputStream in = filterConfig.getServletContext()
        .getResourceAsStream("/WEB-INF/PRIVATE_KEY_JSON.json");
    FirebaseOptions options = null;
    try {
        options = new FirebaseOptions.Builder()
            .setCredentials(GoogleCredentials.fromStream(in))
            .build();
    } catch (IOException e) {
        e.printStackTrace();
        // 抛出运行时异常，避免静默失败导致后续功能异常
        throw new RuntimeException("Failed to initialize Firebase Admin SDK", e);
    }
    FirebaseApp.initializeApp(options);
}

验证 #

部署后重新测试，Firebase Admin应该能正常初始化，Android端的令牌验证功能也可以正常工作了。

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