Flutter权限处理中Reply already submitted异常的解决方案

问题背景

在使用Flutter的permission_handler插件进行权限请求时，开发者可能会遇到一个常见的运行时异常：java.lang.IllegalStateException: Reply already submitted。这个异常通常发生在Android平台上，当应用程序同时处理多个权限请求或自定义Activity结果时。

异常原因分析

这个异常的核心问题在于Flutter的MethodChannel结果回调机制。当我们在Android原生代码中处理权限请求的结果时，如果同一个MethodChannel.Result对象被多次调用success()或error()方法，就会触发这个异常。

在permission_handler插件的实现中，它会维护一个结果对象用于回调Flutter端。如果应用程序中其他部分的代码也实现了onActivityResult方法，但没有正确处理请求代码(requestCode)的过滤，就可能导致权限请求的结果被错误处理两次。

典型场景

1. 应用程序自定义了onActivityResult方法
2. 用户请求位置权限时设备定位服务被禁用
3. 系统弹出权限请求对话框
4. 用户做出选择后，结果被错误处理多次

解决方案

要解决这个问题，关键在于正确实现onActivityResult方法中的请求代码过滤。以下是推荐的实现方式：

@Override
public boolean onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    // 首先检查请求代码是否匹配自定义请求
    if (requestCode != myCustomRequestCode) {
        return false; // 不匹配则交给其他处理器处理
    }

    // 以下是自定义请求的处理逻辑
    if (resultCode == RESULT_OK && lastResult != null) {
        try {
            // 处理结果...
            lastResult.success(result);
            lastResult = null; // 清空结果引用
        } catch (Exception error) {
            error.printStackTrace();
        }
        return true;
    }
    return false;
}

关键点说明

1. 请求代码匹配：必须首先检查requestCode是否匹配我们期望的值，不匹配应立即返回false
2. 结果处理：只有在确认是我们要处理的请求时，才执行自定义逻辑
3. 结果清理：处理完成后，必须清空对结果对象的引用
4. 错误处理：妥善捕获和处理可能的异常

最佳实践建议

1. 为每个自定义Activity请求定义唯一的请求代码
2. 在onActivityResult中严格过滤请求代码
3. 避免在多个地方处理同一个请求的结果
4. 及时清理不再需要的结果对象引用
5. 考虑使用更现代的Activity Result API替代传统的onActivityResult

总结

Reply already submitted异常的根本原因是结果回调被多次执行。通过正确实现请求代码过滤和结果处理逻辑，可以避免这个问题。理解Flutter插件与原生平台交互的机制，对于开发稳定的混合应用至关重要。permission_handler作为常用的权限处理插件，其内部机制需要与应用程序的其他部分协调工作，正确的实现方式可以确保权限请求流程的顺畅执行。