基于Bloc的Firebase推送通知推送失败，报FormatException异常

我已基于Firebase完成推送通知功能的搭建，当前推送操作执行失败，返回的错误信息不够清晰，具体报错如下：

FormatException: Unexpected end of input (at character 1)

项目中使用Bloc作为状态管理框架，相关PushNotificationsBloc的实现代码如下：

class PushNotificationsBloc
    extends Bloc<PushNotificationsEvent, PushNotificationsState> {
  final UserDataRepository userDataRepository;

  PushNotificationsBloc({this.userDataRepository})
      : super(PushNotificationsInitial());

  @override
  Stream<PushNotificationsState> mapEventToState(
    PushNotificationsEvent event,
  ) async* {
    if (event is SendNewNotification) {
      yield* mapSendNewNotificationToState(event.map);
    }
  }

  Stream<PushNotificationsState> mapSendNewNotificationToState(Map map) async* {
    yield SendNewNotificationInProgressState();
    try {
      String res = await userDataRepository.sendNewNotification(map);
      if (res != null) {
        yield SendNewNotificationCompletedState(res);
      } else {
        yield SendNewNotificationFailedState();
      }
    } catch (e) {
      print(e);
      yield SendNewNotificationFailedState();
    }
  }
}

请问该异常的产生原因是什么，应如何排查与解决？

异常本质 #

FormatException: Unexpected end of input (at character 1) 是JSON/数据序列化模块尝试解析长度为0的空内容时抛出的典型错误，说明你在调用推送相关接口后，解析返回响应的环节拿到了空内容。

产生原因 #

• 调用Firebase云消息发送接口时，请求参数格式错误、权限校验失败，服务端直接返回了无响应体的响应（如204 No Content、4xx错误空响应），代码未做判断直接解析空内容触发报错
• userDataRepository.sendNewNotification() 方法内部的HTTP请求逻辑有缺陷，未先判断响应状态和响应体是否为空，直接执行解析操作
• 传入mapSendNewNotificationToState的map参数存在必填字段缺失、字段类型错误，导致请求未正常发出就触发解析逻辑，拿到空值

排查步骤 #

1. 在sendNewNotification方法的请求环节添加完整日志，打印请求的完整参数、请求头、接口地址，以及返回的HTTP状态码、原始响应内容，确认是否返回了空响应
2. 核对传入的map参数结构是否符合Firebase FCM发送接口的要求，确认通知标题、接收方token、消息类型等必填字段没有缺失、格式符合要求
3. 检查FCM接口的权限配置，包括服务端密钥、请求权限范围，确认没有因权限被拦截返回空响应

解决方法 #

1. 给响应解析逻辑添加空判断，以Dio请求为例，修改sendNewNotification内部逻辑：

final response = await dio.post(/* FCM发送接口地址 */, data: map);
if (response.statusCode == 200 && response.data != null && response.data.toString().trim().isNotEmpty) {
  // 正常解析响应内容
  return jsonEncode(response.data);
} else {
  // 主动抛出明确的错误信息，方便定位
  throw Exception("推送请求失败，状态码：${response.statusCode}，响应内容为空");
}

2. 优化Bloc的错误捕获逻辑，透传错误信息方便后续排查：

catch (e) {
  print("发送通知出错：$e");
  // 建议给SendNewNotificationFailedState新增errorMsg字段存储错误信息
  yield SendNewNotificationFailedState(errorMsg: e.toString());
}

3. 对照Firebase官方文档核对FCM发送请求的参数结构，确保所有必填字段都正确传入。

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