Flutter自定义后台任务报错：-32601 Method not found 求助

这个-32601的「方法未找到」错误我之前折腾Flutter后台任务时也碰到过，结合你贴的代码来看，核心问题出在Dart和原生MethodChannel的调用匹配环节，咱们一步步排查解决：

1. 先盯紧原生端的MethodChannel方法匹配 #

你的Dart代码明确调用了periodic方法，还传了一个装着handle的列表：

_channel.invokeMethod(
  'periodic',
  <dynamic>[handle.toRawHandle()],
);

但原生端如果没正确接住这个方法，或者参数解析错了，就会直接抛出“方法未找到”。你得确认原生的onMethodCall里是不是完整处理了这个方法，比如：

override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
    when (call.method) {
        "periodic" -> {
            // 划重点：Dart传的是列表，不能直接转成Long，得先取列表第一个元素
            val arguments = call.arguments as List<*>
            val handle = arguments[0] as Long
            
            // 你的WorkManager构建逻辑可以保留
            val data = Data.Builder().putLong("handle", handle).build()
            val constrains = Constraints.Builder()
                .setRequiredNetworkType(NetworkType.CONNECTED)
                .build()
            val pWorkRequest = PeriodicWorkRequest
                .Builder(CustomWorker::class.java, 15, TimeUnit.MINUTES)
                .setInputData(data)
                .setConstraints(constrains)
                .build()
            WorkManager.getInstance(context).enqueue(pWorkRequest)
            
            // 一定要调用result.success()！不然Dart端会一直等，也会触发错误
            result.success(true)
        }
        else -> {
            // 其他没实现的方法，返回notImplemented就行
            result.notImplemented()
        }
    }
}

这里有三个容易踩的坑：

• 没写call.method == "periodic"的判断，原生直接走了notImplemented分支
• 把Dart传的列表直接当成Long解析，导致报错中断
• 处理完逻辑忘了调用result.success()，Dart端超时触发错误

2. 确认你传的回调函数符合要求 #

Flutter的PluginUtilities.getCallbackHandle只认顶级函数或者静态类方法，如果你传的是某个State类里的实例方法，handle会直接变成null（不过你的代码里有判断handle != null，所以这个可能不是当前错误的主因，但还是得确认下）：

// 正确示例：顶级函数
void myBackgroundTask() {
  print("后台任务跑起来啦");
}

// 调用的时候这么传
Backgroundtask.periodic(callback: myBackgroundTask);

// 或者静态方法也可以
class TaskManager {
  static void runBackgroundTask() {
    print("静态方法版后台任务");
  }
}
// 调用
Backgroundtask.periodic(callback: TaskManager.runBackgroundTask);

3. 顺便优化下Worker里的引擎逻辑（避免后续踩坑） #

虽然这不是当前错误的原因，但你的CustomWorker代码有几个潜在问题，提前改了能省不少事：

• 每次doWork都新建FlutterEngine太浪费资源，要么用FlutterEngineCache缓存，要么用完就销毁
• 没必要用Handler切到主线程，FlutterEngine初始化在后台线程就能搞定
• 执行完回调记得销毁引擎，防止内存泄漏

修正后的Worker代码参考：

class CustomWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
    override fun doWork(): Result {
        Log.d("periodic", "后台任务启动")
        val handle = inputData.getLong("handle", 0)
        val flutterCallback = FlutterCallbackInformation.lookupCallbackInformation(handle)
        
        if (flutterCallback.callbackName == null) {
            Log.e("periodic", "找不到对应的回调函数")
            return Result.failure()
        }
        
        // 初始化Flutter引擎
        val flutterEngine = FlutterEngine(applicationContext)
        val dartCallback = DartExecutor.DartCallback(
            applicationContext.assets,
            FlutterMain.findAppBundlePath(),
            flutterCallback
        )
        flutterEngine.dartExecutor.executeDartCallback(dartCallback)
        
        // 如果你的任务是耗时操作，这里要合理处理等待逻辑，比如用CountDownLatch之类的
        Thread.sleep(2000)
        
        // 用完销毁引擎，释放资源
        flutterEngine.destroy()
        
        Log.d("periodic", "后台任务结束")
        return Result.success()
    }
}

最后总结 #

当前的-32601错误90%概率是原生端没正确匹配periodic方法，或者参数解析错了，先把第一点的原生代码修正，确保方法名一致、参数解析正确，并且调用result.success()完成调用，应该就能解决问题了。

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