Android registerForActivityResult调用时机错误报错解决方案

registerForActivityResult API 对注册时机有强校验，官方报错提示如下：

Fragment XXX is attempting to registerForActivityResult after being created. Fragments must call registerForActivityResult() before they are created (i.e. initialization, onAttach(), or onCreate()).

即Fragment/Activity必须在创建完成前（初始化阶段、onAttach()、onCreate()生命周期内）调用该方法注册结果回调，创建完成后再调用注册就会抛出异常。
你的代码中requestPermissionLauncher是PermissionUtils的成员属性，初始化时机和PermissionUtils实例化时机完全一致。绝大多数场景下你会在Fragment的onViewCreated、控件点击事件等Fragment已经创建完成的节点初始化PermissionUtils，此时才调用fragment.registerForActivityResult()，自然触发校验失败。
另外原代码存在隐藏bug：无论传入什么权限参数，实际发起申请的都是硬编码的WRITE_EXTERNAL_STORAGE权限，和传入参数不匹配。

核心原则：保证registerForActivityResult的调用时机落在Fragment的合规生命周期阶段，工具类仅负责权限校验、申请发起、回调分发逻辑，参考实现如下：

调整后的PermissionUtils代码 #

class PermissionUtils private constructor(
    private val context: Context,
    private val requestPermissionLauncher: ActivityResultLauncher<String>
) {

    private lateinit var callBack: PermissionsListenerCallback

    fun requestPermission(permission: String, callBack: PermissionsListenerCallback) {
        this.callBack = callBack
        if (ContextCompat.checkSelfPermission(context, permission) == PackageManager.PERMISSION_GRANTED) {
            this.callBack.onPermissionGranted()
        } else {
            requestPermissionLauncher.launch(permission)
        }
    }

    private fun showPermissionsDialog() {
        // 实现自定义权限说明弹窗逻辑，用户取消时调用callBack.onPermissionDialogCancel()
    }

    fun handlePermissionResult(isGranted: Boolean) {
        if (isGranted) {
            callBack.onPermissionGranted()
        } else {
            showPermissionsDialog()
        }
    }

    interface PermissionsListenerCallback {
        fun onPermissionGranted()
        fun onPermissionDialogCancel()
    }

    companion object {
        private var instance: PermissionUtils? = null

        fun create(fragment: Fragment): PermissionUtils {
            lateinit var utils: PermissionUtils
            // launcher注册放在create方法中，跟随Fragment onCreate时机调用，符合校验要求
            val launcher = fragment.registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->
                utils.handlePermissionResult(isGranted)
            }
            utils = PermissionUtils(fragment.requireContext(), launcher)
            instance = utils
            return utils
        }

        fun get(): PermissionUtils {
            return instance ?: throw IllegalStateException("请先在Fragment的onCreate方法中调用PermissionUtils.create(fragment)完成初始化")
        }
    }
}

Fragment中的调用方式 #

class TargetFragment : Fragment() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 必须在onCreate阶段初始化工具类，保证Launcher注册时机合规
        PermissionUtils.create(this)
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 比如点击按钮时申请权限
        requestPermissionBtn.setOnClickListener {
            PermissionUtils.get().requestPermission(
                permission = Manifest.permission.WRITE_EXTERNAL_STORAGE,
                callBack = object : PermissionUtils.PermissionsListenerCallback {
                    override fun onPermissionGranted() {
                        // 权限授予后的业务逻辑
                    }

                    override fun onPermissionDialogCancel() {
                        // 用户拒绝权限、关闭说明弹窗的逻辑
                    }
                }
            )
        }
    }
}

• 不要尝试通过反射修改Fragment生命周期标记、绕过系统校验的方式解决问题，这类方案在AndroidX版本升级后极易失效，还可能引发内存泄漏、Fragment状态不一致的隐性bug。
• 如果需要同时申请多个权限，可以把ActivityResultContracts.RequestPermission()替换为ActivityResultContracts.RequestMultiplePermissions()，对应调整入参和回调逻辑即可。
• 如果工具类需要在Activity中使用，实现逻辑完全一致，只要保证在Activity的onCreate阶段调用registerForActivityResult即可。

内容的提问来源于stack exchange，提问作者Owies AL omari