Noticed gem中FCM推送方法的配置问题解析

问题背景

在使用Noticed gem(一个Ruby on Rails的通知系统)的FCM(Firebase Cloud Messaging)推送功能时，开发者可能会遇到两个关键问题：

1. 当尝试将config[:json]设置为方法符号(如:android_format)时，系统会抛出NoMethodError异常
2. 即使使用lambda表达式配置JSON格式，FCM API也会返回400错误，提示无效的JSON负载

问题分析

方法符号调用问题

在Noticed gem的FCM推送实现中，当config[:json]被设置为方法符号时，代码尝试在字符串实例上调用该方法，这显然是不正确的。正确的做法应该是在通知实例上调用该方法。

FCM API格式问题

FCM API v1要求特定的JSON格式结构，需要将推送内容包装在message对象中。当前实现直接发送内部结构，导致API无法识别有效字段。

解决方案

方法调用修正

对于方法符号调用问题，可以借鉴iOS推送的实现方式，添加一个format_notification方法：

def format_notification(device_token)
  if (method = config[:json])
    if method.is_a?(Symbol) && notification.respond_to?(method)
      notification.send(method, device_token)
    else
      notification.instance_exec(device_token, &method)
    end
  else
    raise ArgumentError, "No json for fcm delivery"
  end
end

FCM格式修正

对于FCM API格式问题，需要确保推送内容符合v1 API规范：

config.json = ->(device_token) {
  {
    message: {
      token: device_token,
      notification: {
        title: "Test Title",
        body: "Test body"
      }
    }
  }
}

最佳实践

1. 方法定义：在通知类中定义格式方法，保持代码整洁

def android_format(device_token)
  {
    message: {
      token: device_token,
      notification: {
        title: params[:title],
        body: params[:body]
      }
    }
  }
end

2. 配置方式：选择最适合项目的方式配置JSON格式

# 方式1：直接使用lambda
deliver_by :fcm do |config|
  config.json = ->(token) { ... }
end

# 方式2：使用方法符号
deliver_by :fcm do |config|
  config.json = :android_format
end

3. 错误处理：实现无效token处理逻辑

deliver_by :fcm do |config|
  config.invalid_token = ->(token) {
    user = User.find_by(fcm_token: token)
    user.update(fcm_token: nil) if user
  }
end

总结

Noticed gem的FCM推送功能需要特别注意两点：方法调用的正确上下文和FCM API v1的格式要求。通过实现format_notification方法和确保正确的JSON包装结构，可以解决当前遇到的问题。这些改进不仅修复了现有bug，还提供了更灵活的配置方式，使开发者能够根据项目需求选择最适合的实现方式。