升级compileSdkVersion至33后，ActivityResultAPI回调未触发求助

核心修复方案 #

1. 改用官方适配的媒体选择Contract #

放弃StartActivityForResult通用Contract，直接使用专为媒体选择设计的GetContent或OpenDocument，这两个Contract已适配API33+的系统行为：

// 注册单图选择Launcher
private val fileChooserLauncher = registerForActivityResult(ActivityResultContracts.GetContent()) { uri: Uri? ->
    uri?.let {
        Log.i(TAG, "选中图片URI: $it")
        // 处理选中文件逻辑
    } ?: run {
        Log.i(TAG, "未选中任何文件")
    }
}

// 启动选择器的方法
fun launchImagePicker() {
    fileChooserLauncher.launch("image/*")
}

如果需要支持多选，改用GetMultipleContents：

private val multiFileChooserLauncher = registerForActivityResult(ActivityResultContracts.GetMultipleContents()) { uris: List<Uri>? ->
    uris?.let {
        Log.i(TAG, "选中${it.size}张图片")
        // 批量处理逻辑
    }
}

2. 正确处理API33+的媒体权限 #

在Android 13及以上，访问图片需要READ_MEDIA_IMAGES权限，需完成静态声明+动态申请：

第一步：在AndroidManifest.xml中声明权限

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- 兼容API32及以下版本的旧权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

第二步：动态申请权限

private val permissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
    if (granted) {
        launchImagePicker() // 权限通过后启动选择器
    } else {
        // 提示用户开启权限
    }
}

// 调用权限申请并启动选择器
fun requestPermissionAndLaunch() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_IMAGES) != PackageManager.PERMISSION_GRANTED) {
            permissionLauncher.launch(Manifest.permission.READ_MEDIA_IMAGES)
        } else {
            launchImagePicker()
        }
    } else {
        // 处理API32及以下的旧权限逻辑
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            // 申请READ_EXTERNAL_STORAGE权限
        } else {
            launchImagePicker()
        }
    }
}

原代码失效原因 #

• StartActivityForResult是通用型Contract，搭配ACTION_CHOOSER在API33+的系统应用（如相册、文件管理器）中，因系统权限逻辑变更，导致结果无法正确传递到你的回调。
• 官方专用的媒体选择Contract（GetContent/OpenDocument）已针对不同Android版本做了适配，稳定性远高于通用Contract。

额外排查点 #

1. Launcher注册时机：必须在Activity/Fragment的onCreate或更早生命周期方法中调用registerForActivityResult，不能在点击事件等动态时机注册，否则会导致回调绑定失败。
2. 依赖版本升级：尝试将activity和fragment依赖升级到最新稳定版，旧版本可能存在API33适配bug：

   implementation("androidx.activity:activity-ktx:1.8.2")
   implementation("androidx.fragment:fragment-ktx:1.6.2")
   

3. Activity启动模式：避免使用singleInstance或singleTask启动模式，这类模式会干扰结果返回逻辑。

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