添加Firebase SDK后无法部署Web应用至GlassFish 5/Payara 5：找不到FirebaseOptions$Builder

我来帮你搞定这个部署报错的问题——这个NoClassDefFoundError本质上就是Payara服务器找不到Firebase Admin SDK的核心类，大概率是依赖没被正确打包到你的Web应用里，或者服务器没加载到这些依赖。下面给你几个靠谱的解决步骤：

1. 先确认Maven依赖配置没问题 #

首先检查你的pom.xml里的Firebase Admin SDK依赖是否正确，别写错groupId、artifactId或者版本号。正确的依赖配置应该是这样的（建议用最新的稳定版，比如下面的9.2.0，你也可以根据需求调整）：

<dependency>
    <groupId>com.google.firebase</groupId>
    <artifactId>firebase-admin</artifactId>
    <version>9.2.0</version>
</dependency>

注意不要手动指定scope，默认的compile范围会让Maven把这个依赖连同它所有的传递依赖都打包到WAR包的WEB-INF/lib目录里，这是关键。

2. 确保Maven打包时包含所有依赖 #

执行Maven的clean package命令重新打包项目，然后打开生成的WAR文件，检查WEB-INF/lib目录下是否有firebase-admin-xxx.jar，以及一堆Google相关的依赖包（比如google-api-client、guava这些）。如果缺了某个包，那就是Maven打包时没拉全，你可以试试右键项目 → Maven → Update Project，刷新依赖后再重新打包。

3. 检查Eclipse的部署配置 #

有时候Eclipse的Maven项目部署配置会抽风，导致依赖没被包含到部署包中：

• 右键你的项目 → Properties → Deployment Assembly
• 看看列表里有没有Maven Dependencies，并且它的部署路径是WEB-INF/lib
• 如果没有的话，点击Add → 选择Maven Dependencies添加进去，然后重新部署

4. 极端情况：全局添加依赖到Payara（不推荐） #

如果上面的方法都不行，你可以试试把Firebase Admin SDK的所有依赖jar包复制到Payara服务器的domains/domain1/lib/ext目录下，然后重启服务器。这样服务器会全局加载这些依赖，不过这种方式会影响服务器上的所有应用，所以尽量先用前面的方法解决。

额外排查点 #

• 确认你的Java版本和Firebase SDK版本兼容：Payara 5支持Java 8及以上，所以尽量用Java 8+，并且Firebase SDK版本不要太旧，避免兼容性问题。
• 仔细看Payara的完整日志，有没有ClassNotFoundException的根源信息，有时候是某个传递依赖缺失导致的，比如Guava或者Google的其他核心库没被加载。

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