API 21环境下图片上传失败，触发NPE及IllegalStateException求助

看起来你遇到的核心问题是API版本兼容性差异——为API23+开发的代码没有适配API21的权限模型和Uri处理逻辑，最终触发空指针异常（NPE），进而导致点击事件执行失败。下面是针对性的解决方案：

1. 先理清错误根源 #

• 空指针（NPE）：大概率是SaveImageInFirebase方法中使用的图片Uri为空。API21下获取图片的方式和API23+存在差异，若直接复用高版本逻辑，会导致Uri无法正确获取。
• IllegalStateException：这个错误本质是onClick绑定的方法执行时出现了未捕获的NPE，并非点击事件绑定本身的问题，解决NPE后这个错误也会消失。

2. 适配存储权限逻辑 #

API23引入了运行时权限机制，但API21仍采用安装时授权模式。你的代码可能只处理了高版本的动态权限申请，导致API21下权限校验不通过，无法访问图片文件：

private fun checkStoragePermission(): Boolean {
    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        // API23+ 动态校验权限
        ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED
                && ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED
    } else {
        // API21及以下 直接校验Manifest中声明的权限
        packageManager.checkPermission(Manifest.permission.READ_EXTERNAL_STORAGE, packageName) == PackageManager.PERMISSION_GRANTED
                && packageManager.checkPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE, packageName) == PackageManager.PERMISSION_GRANTED
    }
}

在上传按钮的点击方法中，先调用这个校验逻辑：

fun onUploadClick(view: View) {
    if (!checkStoragePermission()) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            requestPermissions(arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE), 1001)
        } else {
            Toast.makeText(this, "请前往设置开启存储权限", Toast.LENGTH_SHORT).show()
        }
        return
    }
    // 这里执行图片选择和上传逻辑
}

3. 修复图片Uri获取逻辑 #

API23+常用的FileProvider获取Uri的方式在API21下可以直接用Uri.fromFile()替代（无需配置FileProvider），避免Uri为空：

private fun getImageFileUri(imageFile: File): Uri {
    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        // API24+ 用FileProvider（API23也兼容，但API21不需要）
        FileProvider.getUriForFile(this, "${packageName}.fileprovider", imageFile)
    } else {
        // API21及以下 直接用Uri.fromFile
        Uri.fromFile(imageFile)
    }
}

4. 给SaveImageInFirebase加空安全校验 #

直接定位到register.kt第125行，给关键变量加兜底判断，避免NPE：

fun SaveImageInFirebase(imageUri: Uri?) {
    // 先判断Uri是否为空，提前拦截NPE
    imageUri ?: run {
        Log.e("UploadError", "图片Uri为空，请检查图片选择逻辑")
        Toast.makeText(this@RegisterActivity, "图片获取失败，请重新选择", Toast.LENGTH_SHORT).show()
        return
    }

    // 后续Firebase上传逻辑
    val storageRef = FirebaseStorage.getInstance().reference.child("user_images/${UUID.randomUUID()}")
    storageRef.putFile(imageUri)
        .addOnSuccessListener {
            // 上传成功后的处理
        }
        .addOnFailureListener { e ->
            Log.e("UploadError", "图片上传失败", e)
        }
}

最后注意事项 #

• 确保AndroidManifest.xml中已声明存储权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

• 测试时一定要在API21的模拟器/设备上验证每一步，比如选择图片后打印Uri，确认它不为空。

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