FlutterFlow自定义Action编译无描述错误排查求助

问题背景 #

• 编写的自定义Action编译持续报错，但无任何错误提示
• 相同逻辑转为自定义函数可正常运行
• 所用Action代码如下：

// Automatic FlutterFlow imports
import '/backend/schema/structs/index.dart';
import '/flutter_flow/flutter_flow_theme.dart';
import '/flutter_flow/flutter_flow_util.dart';
import '/custom_code/actions/index.dart'; // Imports other custom actions
import '/flutter_flow/custom_functions.dart'; // Imports custom functions
import 'package:flutter/material.dart';
// Begin custom action code
// DO NOT REMOVE OR MODIFY THE CODE ABOVE!

import 'dart:convert';

// Set your action name, define your arguments and return parameter,
// and then add the boilerplate code using the button on the right!
UserStruct decodeToken(String token) {
  UserStruct user = UserStruct();
  // Add your function code here!
  final parts = token.split('.');
  if (parts.length != 3) {
    return user;
  }

  final encodedPayload = parts[1];
  final normalizedPayload = base64Url.normalize(encodedPayload);
  final decodedPayload = utf8.decode(base64Url.decode(normalizedPayload));
  final payloadData = json.decode(decodedPayload);

  if (payloadData is! Map<String, dynamic>) {
    return user;
  }

  if (payloadData.containsKey("sub")) {
    user.sub = payloadData["sub"];
  }
  if (payloadData.containsKey("auth0")) {
    user.sub = payloadData["auth0"];
  }

  return user;
}

问题原因分析 #

问题出在自定义Action的结构不符合FlutterFlow的规则，而非代码逻辑本身：

1. 函数类型不符合要求
   FlutterFlow的自定义Action必须是异步函数（返回Future<T>类型），但你的代码是同步函数（直接返回UserStruct），框架无法识别这种结构的Action。
2. 缺少强制参数
   自定义Action必须包含BuildContext context参数，即使你在逻辑中不需要使用它。你的函数签名缺少该参数，导致编译流程异常。
3. 自定义函数与Action的规则差异
   自定义函数的结构要求更宽松，同步函数即可运行，但Action是FlutterFlow用于页面交互的逻辑单元，必须遵循框架的异步+上下文参数的规范。

修正后的代码示例 #

// Automatic FlutterFlow imports
import '/backend/schema/structs/index.dart';
import '/flutter_flow/flutter_flow_theme.dart';
import '/flutter_flow/flutter_flow_util.dart';
import '/custom_code/actions/index.dart'; // Imports other custom actions
import '/flutter_flow/custom_functions.dart'; // Imports custom functions
import 'package:flutter/material.dart';
// Begin custom action code
// DO NOT REMOVE OR MODIFY THE CODE ABOVE!

import 'dart:convert';

Future<UserStruct> decodeToken(String token, BuildContext context) async {
  UserStruct user = UserStruct();
  final parts = token.split('.');
  if (parts.length != 3) {
    return user;
  }

  final encodedPayload = parts[1];
  final normalizedPayload = base64Url.normalize(encodedPayload);
  final decodedPayload = utf8.decode(base64Url.decode(normalizedPayload));
  final payloadData = json.decode(decodedPayload);

  if (payloadData is! Map<String, dynamic>) {
    return user;
  }

  if (payloadData.containsKey("sub")) {
    user.sub = payloadData["sub"];
  }
  if (payloadData.containsKey("auth0")) {
    user.sub = payloadData["auth0"];
  }

  return user;
}

总结 #

将函数改为异步类型并添加BuildContext参数后，即可符合FlutterFlow自定义Action的编译要求。之前的编译失败是因为结构不匹配，并非代码逻辑或平台本身的问题。

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