Flutter调用Firebase Cloud Function参数无法被接收的问题求助

问题详情 #

1. Flutter端调用代码 #

final result =
          await FirebaseFunctions.instance.httpsCallable('example').call(
        {
          'test1': 'test1',
          'test2': 'test2', // 原代码存在语法错误：缺少闭合单引号
        },
      );

2. 云端Cloud Function代码（Python） #

@functions_framework.http
def generate_post(request) -> https_fn.Response:
    # Print headers
    print("Headers:")
    for header, value in request.headers.items():
        print(f"{header}: {value}")

    # Print query parameters
    print("\nQuery Parameters:")
    for param, value in request.args.items():
        print(f"{param}: {value}")

    # Print form data
    print("\nForm Data:")
    for field, value in request.form.items():
        print(f"{field}: {value}")

    # Print JSON data
    data = request.get_json(silent=True)
    print("\nJSON Data:")
    print(data)

    # Print raw data
    print("\nRaw Data:")
    print(request.data.decode('utf-8'))
    logging.info(f"Request data: {request.data}")

3. 异常现象 #

• Flutter调用时，云端打印的请求头、查询参数、表单数据、JSON数据、原始数据均为空
• Postman直接调用该Cloud Function可正常读取参数

4. 依赖版本 #

cupertino_icons: ^1.0.6
firebase_core: ^3.1.1
firebase_auth: ^5.1.1
cloud_firestore: ^5.0.2
flutter_redux: ^0.10.0
redux: ^5.0.0
shared_preferences: ^2.2.3
cloud_functions: ^5.0.3
http: ^1.2.2

5. Flutter版本 #

flutter --version
Flutter 3.19.3 • channel stable • https://github.com/flutter/flutter.git
Framework • revision ba39319843 (5 months ago) • 2024-03-07 15:22:21 -0600
Engine • revision 2e4ba9c6fb
Tools • Dart 3.3.1 • DevTools 2.31.1

解决思路 #

1. 修正Flutter端语法错误 #

原代码中'test2': 'test2,缺少闭合单引号，会导致Dart代码运行异常，直接修正为'test2': 'test2'，确保参数能正常序列化发送。

2. 适配Callable Functions的请求格式 #

Firebase的httpsCallable会将参数包裹在data字段中发送，而非直接作为顶层JSON对象。云端需要从request.get_json()的data键提取参数：

# 替换原JSON数据读取逻辑
data = request.get_json(silent=True)
if data and 'data' in data:
    actual_params = data['data']
    print("\nCallable Function Parameters:")
    print(actual_params)
else:
    print("\nNo callable parameters found")

Postman测试时你可能直接发送了顶层JSON，所以能正常读取，但Flutter插件会自动封装参数，必须适配该格式。

3. 确认函数区域匹配 #

如果云端函数部署时指定了区域（如us-central1），Flutter端需要对应配置：

// 指定部署区域
final functions = FirebaseFunctions.instanceFor(region: 'us-central1');
final result = await functions.httpsCallable('example').call({
  'test1': 'test1',
  'test2': 'test2'
});

区域不匹配会导致请求路由错误，参数无法传递。

4. 本地调试验证 #

使用Firebase Functions模拟器本地排查：

1. 启动模拟器：firebase emulators:start --only functions
2. Flutter端连接模拟器：FirebaseFunctions.instance.useFunctionsEmulator('localhost', 5001);
3. 调用函数后查看本地日志，确认参数是否正常到达。

5. 升级依赖版本 #

尝试升级cloud_functions和firebase_core到最新稳定版，修复潜在的序列化bug：

cloud_functions: ^5.3.0
firebase_core: ^3.5.0

执行flutter pub upgrade更新后重新测试。

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