Firebase Cloud Messaging自定义通知声音无法播放问题求助（React Native场景）

我之前也碰到过几乎一模一样的问题，折腾了好一阵子才捋清楚逻辑，结合你的代码和描述，给你梳理几个关键排查点和解决方案：

1. 先把资源文件的基础配置做对 #

这是最容易踩坑的第一步，先确保你的自定义声音文件没问题：

• 文件名必须是小写字母+下划线，绝对不能有空格、大写字母或特殊字符（比如my_sound.mp3是正确的，MySound.mp3或者my sound.mp3直接会失效）
• 格式优先用MP3（Android对MP3的兼容性最好），确保文件本身能正常播放
• 放在android/app/src/main/res/raw目录下，如果没有raw文件夹就手动创建（注意是全小写的raw，不能写成Raw）
• 确保构建工具同步了这个文件：如果用Android Studio，右键raw文件夹选「Sync Project with Gradle Files」；用命令行的话，先跑一遍cd android && ./gradlew clean再重新打包

2. 区分远程FCM通知和本地通知的配置差异 #

你代码里同时涉及了FCM远程推送和本地通知，这两者的声音配置逻辑完全不同，别搞混了：

针对FCM远程通知（你发送的message对象） #

FCM的notification.sound字段在Android 8.0+（API 26）上会被通知通道的声音设置覆盖，所以重点是给远程通知绑定正确的通道，而不是单独设置sound字段：

const message = { 
  "to": userFinded.deviceToken, 
  "notification": { 
    "title": 'Body test', 
    "color": '#ff9d00',
    "android_channel_id": "fcm_fallback_notification_channel" // 必须指定已创建的通道ID
  },
  "data": {
    // 自定义参数可以放在这里
  }
};

另外，FCM的notification.sound字段如果要生效，需要是不带后缀的文件名（比如my_sound），但因为通道优先级更高，建议直接依赖通道配置。

针对本地通知和通道创建 #

通道必须在App启动时就创建，而且配置要准确：

// 在App初始化时调用（比如App.js的useEffect或componentDidMount里）
PushNotification.createChannel(
  {
    channelId: 'fcm_fallback_notification_channel', // 和远程通知的android_channel_id完全一致
    channelName: 'Custom Sound Channel',
    channelDescription: 'Channel for notifications with custom sound',
    soundName: 'my_sound.mp3', // 这里必须带文件后缀！
    importance: 4, // 确保通知能正常弹出（值越高优先级越高）
    vibrate: true,
  },
  (created) => console.log(`Channel created status: ${created}`) // 确认通道是否创建成功
);

// 本地通知的正确配置
PushNotification.localNotification({
  channelId: 'fcm_fallback_notification_channel',
  title: 'Local Test Notification',
  message: 'Custom sound playback test',
  soundName: 'my_sound.mp3', // 同样要带后缀
});

3. 避开几个高频踩坑点 #

• 包名不能乱写：如果你尝试过android.resource://com.seeed/raw/my_sound这种格式，com.seeed必须是你App的真实包名（也就是android/app/build.gradle里applicationId字段的值），写错包名直接找不到资源
• 通道创建后无法修改：Android系统会缓存通知通道的配置，一旦创建成功，修改soundName等参数不会生效。测试时可以直接卸载重装App，或者在代码里先删除旧通道再创建新的（生产环境不建议这么做）
• 别加默认声音配置：不要在代码里写default: 'default'，这会强制播放系统默认声音，直接覆盖你的自定义设置
• 注意FCM消息类型：如果你的FCM消息是纯data类型（没有notification字段），系统不会自动弹出通知，需要你在onNotification回调里手动调用localNotification来触发，这时候就用本地通知的配置即可

4. 最后一步：系统设置检查 #

如果以上配置都没问题还是没声音，去Android系统设置里确认：
进入「设置→应用→你的App→通知」，找到对应的通道（fcm_fallback_notification_channel），查看声音是否被设置为你的自定义声音。有时候系统会自动重置通道配置，手动选一次就能解决。

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