FCM Django完全指南：如何通过Django快速集成Firebase推送通知

最新推荐文章于 2026-06-22 13:34:32 发布
原创 最新推荐文章于 2026-06-22 13:34:32 发布 · 968 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

FCM Django完全指南：如何通过Django快速集成Firebase推送通知

【免费下载链接】fcm-django FCM Django: Send push notifications via django to websites, iOS & android mobile devices through FCM (Firebase Cloud Messaging) 【免费下载链接】fcm-django 项目地址: https://gitcode.com/gh_mirrors/fc/fcm-django

FCM Django是一个强大的Django应用，它提供了统一的平台，让开发者能够通过Firebase Cloud Messaging (FCM) 向网站、iOS和Android移动设备发送推送通知。本文将为你提供一个简单而全面的指南，帮助你快速上手FCM Django，实现跨平台的推送功能。

为什么选择FCM Django？

FCM Django作为Firebase Cloud Messaging的Django集成方案，具有以下核心优势：

  • 多平台支持：统一支持Android、iOS和Web平台的推送通知
  • 强大的设备管理：自动处理设备注册、状态跟踪和失效设备清理
  • 灵活的消息类型：支持通知消息和数据消息两种类型
  • 批量发送功能：支持向多个设备或主题发送消息
  • Django REST Framework集成：提供现成的API端点用于设备管理
  • 自动设备清理：自动标记无法接收通知的设备为非活动状态

快速安装与配置步骤

1. 安装FCM Django

通过pip可以轻松安装FCM Django：

pip install fcm-django

2. 配置Django项目

编辑你的settings.py文件，添加必要的配置：

from firebase_admin import initialize_app

INSTALLED_APPS = (
    ...
    "fcm_django"
    ...
)

# 初始化Firebase应用
FIREBASE_APP = initialize_app()

FCM_DJANGO_SETTINGS = {
    # 默认Firebase应用实例
    "DEFAULT_FIREBASE_APP": None,
    # 应用名称
    "APP_VERBOSE_NAME": "FCM Django",
    # 是否每个用户只允许一个活动设备
    "ONE_DEVICE_PER_USER": False,
    # 是否删除无法接收通知的设备
    "DELETE_INACTIVE_DEVICES": False,
}

3. 执行数据库迁移

FCM Django包含必要的数据库迁移文件，执行以下命令应用迁移：

python manage.py migrate

FCMDevice模型详解

FCM Django的核心是FCMDevice模型，它存储设备信息和推送令牌。主要字段包括：

  • registration_id：必需，FCM令牌
  • name：可选，设备名称
  • active：默认true，表示设备是否活动
  • user：可选，关联的用户
  • device_id：可选，用于唯一标识设备
  • type：设备类型，可选值为'android'、'web'或'ios'

发送推送通知的两种方式

1. 通知消息

通知消息会自动显示在用户设备的通知中心：

from firebase_admin.messaging import Message, Notification
from fcm_django.models import FCMDevice

device = FCMDevice.objects.all().first()
message = Message(
    notification=Notification(title="欢迎使用FCM Django", body="这是一条测试通知"),
)
device.send_message(message)

2. 数据消息

数据消息不会自动显示，需要客户端应用自行处理：

from firebase_admin.messaging import Message
from fcm_django.models import FCMDevice

device = FCMDevice.objects.all().first()
message = Message(
    data={
        "type": "alert",
        "content": "您有新的消息",
        "timestamp": "2023-11-01T12:00:00Z"
    },
)
device.send_message(message)

批量发送通知

FCM Django支持向多个设备批量发送通知，这在需要向用户群体发送重要消息时非常有用：

from firebase_admin.messaging import Message
from fcm_django.models import FCMDevice

# 向所有设备发送消息
devices = FCMDevice.objects.all()
response = devices.send_message(Message(data={"message": "重要通知：系统将于今晚维护"}))

# 检查发送结果
if response.has_failures:
    print(f"发送失败: {response.failure_count} 个设备")
    print(f"失败的设备ID: {response.failed_registration_ids}")

个性化批量消息

当需要向不同用户发送个性化内容时，可以使用send_bulk_personalized_messages方法：

from fcm_django.models import FCMDevice

FCMDevice.objects.send_bulk_personalized_messages(
    title_template="Hello {name}",
    body_template="您有 {count} 条新消息",
    message_data={
        "token-1": {"name": "Alice", "count": 3},
        "token-2": {"name": "Bob", "count": 7},
    },
    data_fields={"type": "notification"},
)

主题订阅与消息发送

FCM支持基于主题的消息发送，允许用户订阅感兴趣的主题：

from fcm_django.models import FCMDevice
from firebase_admin.messaging import Message

# 订阅主题
FCMDevice.objects.filter(user__is_staff=True).handle_topic_subscription(True, topic="staff-updates")

# 向主题发送消息
FCMDevice.send_topic_message(
    Message(notification=Notification(title="员工通知", body="明天将举行全体会议")),
    "staff-updates"
)

Django REST Framework集成

FCM Django提供了两个视图集用于设备管理：

1. FCMDeviceViewSet

允许匿名用户注册设备，不允许重复的registration_id：

from fcm_django.api.rest_framework import FCMDeviceViewSet
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register('devices', FCMDeviceViewSet)

urlpatterns = [
    path('api/', include(router.urls)),
]

2. FCMDeviceAuthorizedViewSet

要求用户认证，确保设备与用户关联：

from fcm_django.api.rest_framework import FCMDeviceAuthorizedViewSet
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register('devices', FCMDeviceAuthorizedViewSet)

urlpatterns = [
    path('api/', include(router.urls)),
]

高级配置与自定义

使用自定义FCMDevice模型

如果需要扩展设备模型，可以创建自定义模型继承AbstractFCMDevice：

from fcm_django.models import AbstractFCMDevice

class CustomFCMDevice(AbstractFCMDevice):
    # 添加自定义字段
    app_version = models.CharField(max_length=20, blank=True)
    
    class Meta:
        verbose_name = "Custom FCM Device"

然后在settings.py中配置：

FCM_DJANGO_SETTINGS = {
    # 其他设置...
    "FCM_DEVICE_MODEL": "myapp.CustomFCMDevice",
}

多Firebase应用支持

FCM Django支持同时使用多个Firebase应用：

from firebase_admin import initialize_app
from firebase_admin.messaging import Message, Notification
from fcm_django.models import FCMDevice

# 初始化第二个Firebase应用
secondary_app = initialize_app(..., name="secondary")

# 使用第二个应用发送消息
device = FCMDevice.objects.all().first()
device.send_message(
    Message(notification=Notification(title="来自第二个应用", body="这是一条测试消息")),
    app=secondary_app,
)

常见问题与解决方案

1. 设备注册失败

确保设备的registration_id正确，并且Firebase配置正确。检查GOOGLE_APPLICATION_CREDENTIALS环境变量是否设置。

2. 通知发送失败

使用dry_run=True参数测试消息发送，检查返回的错误信息：

response = device.send_message(message, dry_run=True)
if response.has_failures:
    print(response.failed_exceptions)

3. MySQL数据库兼容性

MySQL对索引长度有限制，如果使用MySQL，需要添加以下配置：

FCM_DJANGO_SETTINGS = {
    # 其他设置...
    "MYSQL_COMPATIBILITY": True,
}

版本兼容性

  • Python: 3.10+
  • Django: 4.2+
  • firebase-admin: 6.9+ (如需异步API支持)

总结

FCM Django为Django开发者提供了一个简单而强大的解决方案，用于集成Firebase Cloud Messaging推送通知。通过本文介绍的步骤，你可以快速实现跨平台的推送功能，提升用户体验。无论是简单的通知还是复杂的个性化消息，FCM Django都能满足你的需求。

要了解更多详细信息，可以查看项目的官方文档：docs/index.rst

【免费下载链接】fcm-django FCM Django: Send push notifications via django to websites, iOS & android mobile devices through FCM (Firebase Cloud Messaging) 【免费下载链接】fcm-django 项目地址: https://gitcode.com/gh_mirrors/fc/fcm-django

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值