如何自动化Firebase FCM推送通知发送的集成测试

核心思路是自定义Firebase Admin SDK的HTTP传输层，将FCM请求路由到本地轻量Mock服务，完全规避之前遇到的凭证绑定端点、外部依赖不稳定、模拟器不支持的问题，覆盖从云函数入口到FCM请求构造的全链路逻辑。

具体落地步骤 #

• 第一步：引入轻量本地HTTP Mock依赖，推荐用WireMock或者OkHttp MockWebServer，测试启动时在随机端口拉起Mock服务，不需要任何外部环境依赖。
• 第二步：测试环境下替换Firebase初始化的默认配置，不需要依赖GOOGLE_APPLICATION_CREDENTIALS环境变量，通过SDK公开的扩展点将所有请求转发到本地Mock服务，示例代码：

// 测试专用Firebase初始化逻辑，生产环境不加载这段
FirebaseOptions testOptions = FirebaseOptions.builder()
    // 测试场景下不需要真实凭证，传入格式合法的测试token即可
    .setCredentials(GoogleCredentials.create(new AccessToken("test-valid-token", new Date(Long.MAX_VALUE))))
    // 自定义HTTP传输层，把所有FCM请求路由到本地Mock端口
    .setHttpTransportFactory(() -> new NetHttpTransport.Builder()
        .setHost("127.0.0.1")
        .setPort(mockServicePort)
        .setHttpsRequired(false)
        .build())
    .build();
// 避免重复初始化，先清掉已存在的实例
if (FirebaseApp.getApps().size() > 0) {
    FirebaseApp.getInstance().delete();
}
FirebaseApp.initializeApp(testOptions);

• 第三步：在Mock服务中配置FCM路径匹配规则，拦截所有匹配/v1/projects/**/messages:send的请求，返回标准的FCM成功响应结构，同时缓存收到的请求体内容。
• 第四步：触发云函数执行，等待执行完成后，直接从Mock服务中拉取缓存的请求记录，断言通知标题、内容、推送目标token、自定义数据字段等内容是否符合预期即可。

方案优势 #

对比之前尝试的三种方案，这个实现没有明显短板：

• 对比直接Mock FCM客户端类：走的是Firebase Admin SDK完整的消息序列化、请求构造、签名逻辑，不会因为Mock的方法签名和SDK实际实现不匹配出现“测试全过、线上挂掉”的问题，覆盖度和真实集成场景一致。
• 对比注册真实Android客户端收通知：所有逻辑全程本地运行，单条测试用例执行耗时在毫秒级，没有公网请求、推送延迟等不稳定因素，不需要搭建移动客户端测试环境，维护成本极低。同时可以随意在Mock服务中配置FCM返回的限流、token无效、服务端错误等异常响应，覆盖各种异常分支逻辑。
• 对比依赖Firebase Local Emulator Suite：不需要等待官方更新FCM模拟能力，当前所有版本的Firebase Admin Java SDK都支持自定义HTTP传输的扩展点，兼容性稳定，不会随SDK版本升级失效。

注意避坑 #

• 不要用反射修改SDK内部的端点常量，这种实现方式耦合SDK内部私有逻辑，版本迭代时极易失效，setHttpTransportFactory是SDK公开的稳定API，可放心使用。
• 每个测试用例执行完成后记得调用FirebaseApp.getInstance().delete()清理实例，避免跨用例出现重复初始化的报错。
• 把Firebase初始化逻辑做成可注入的配置：生产环境用默认凭证、默认传输配置，测试环境注入自定义传输的配置即可，不需要修改生产业务逻辑代码。

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