Flutter触发HTTP请求发送数据至Google Cloud Function问题求助

• 参数结构适配检查
  你当前提交的JSON参数外层包裹了data字段，需确认Google Cloud Function（GCF）侧的取值逻辑是否匹配。如果GCF代码是直接读取请求体顶层的email、inviter字段，而非data.email、data.inviter，会因参数缺失导致逻辑执行失败。
• 添加异常捕获逻辑
  你的现有代码未捕获请求过程中的异常，网络波动、跨域拦截、域名解析失败等问题都会导致请求直接中断且无日志输出，修改sendInvitationEmail方法添加异常捕获：

  Future<void> sendInvitationEmail() async {
    try {
      // 原有请求逻辑全部放在try块内
    } catch (e, stackTrace) {
      print('请求执行错误: $e');
      print('错误栈信息: $stackTrace');
    }
  }
  

• 根据状态码定位问题
  你代码中已打印响应状态码，可根据状态码范围排查：
  • 4xx类错误：属于请求侧问题，400代表参数格式错误、401/403代表GCF配置了身份校验你未传入对应凭证、404代表请求URL填写错误
  • 5xx类错误：属于GCF服务侧问题，可直接登录GCP控制台查看对应云函数的运行日志，即可获取具体报错原因（比如SendGrid调用失败、参数取值报错等）
• Web端跨域配置（若适用）
  如果你的应用编译运行在Web端，GCF默认未配置跨域规则会被浏览器直接拦截请求，需要在GCF的代码中添加跨域响应头，Node.js环境的GCF示例如下：

  exports.invite_user = (req, res) => {
    // 配置跨域头
    res.set('Access-Control-Allow-Origin', '*');
    res.set('Access-Control-Allow-Methods', 'POST, OPTIONS');
    res.set('Access-Control-Allow-Headers', 'Content-Type');
    // 处理浏览器预检请求
    if (req.method === 'OPTIONS') {
      return res.status(204).send('');
    }
    // 原有业务逻辑写在下方
  }
  

• 简化HTTP请求写法
  对于新手更推荐使用官方维护的http包替代原生HttpClient，写法更简洁不易出错：
  1. 先在pubspec.yaml中添加依赖：

  dependencies:
    http: ^1.1.0
  

  2. 替换原有请求逻辑：

  import 'package:http/http.dart' as http;
  
  Future<void> sendInvitationEmail() async {
    try {
      const url = 'https://us-east4-wequilschoolapp.cloudfunctions.net/invite_user';
      final emailList = generateEmailListFromString();
      // 若GCF不需要外层data字段，直接把参数放在顶层即可
      final jsonData = {
        'email': emailList,
        'inviter': auth.getUsername,
      };
      final response = await http.post(
        Uri.parse(url),
        headers: {'Content-Type': 'application/json; charset=UTF-8'},
        body: jsonEncode(jsonData),
      );
      print('响应状态码：${response.statusCode}');
      print('响应内容：${response.body}');
    } catch (e) {
      print('请求出错：$e');
    }
  }
  

• SendGrid侧校验
  若GCF日志显示调用SendGrid接口失败，可依次检查：SendGrid API密钥是否配置正确、发件人地址是否完成域名/单邮箱验证、SendGrid控制台的邮件活动列表中是否有对应邮件记录，是否存在退信、拦截情况。

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