小米手机通过URI设置壁纸时应用偶现崩溃问题求助

问题场景 #

应用通过WallpaperManager在Service的onStartCommand中实现壁纸设置逻辑，支持本地存储和Firebase Storage的图片URI。仅小米机型出现崩溃，提示“MiWallpaper已停止运行”，开启/关闭锁屏壁纸切换均可能触发崩溃，偶尔能成功修改锁屏壁纸；其他设备及模拟器无异常。

可能原因 #

• 小米定制ROM的壁纸服务差异：小米对系统壁纸服务做了定制（MiWallpaper），原生WallpaperManager的调用逻辑可能触发其内部未处理的异常，比如权限校验、输入流处理、参数兼容等问题。
• 输入流未正确释放：代码中openInputStream获取的输入流未关闭，可能导致小米壁纸服务处理时出现资源泄漏或IO异常。
• FLAG参数逻辑冲突：使用FLAG_SYSTEM参数时，小米壁纸服务对参数组合的处理逻辑与原生不一致，引发崩溃。
• 同步执行阻塞主线程：在Service的onStartCommand（默认主线程）中同步执行壁纸设置，与小米系统壁纸服务的异步调度逻辑冲突，导致服务崩溃。

修复方案 #

1. 确保输入流自动关闭 #

使用Kotlin的use块自动管理输入流资源，避免泄漏：

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    val uriString = intent?.getStringExtra("uri") ?: run {
        stopSelf()
        return START_NOT_STICKY
    }
    val uri = Uri.parse(uriString)

    contentResolver.openInputStream(uri)?.use { input ->
        val wpm = WallpaperManager.getInstance(this@ChangeBackgroundService)
        if (DataStoreHandler.getLockScreenSwitchState(this)) {
            wpm.setStream(input)
        } else {
            wpm.setStream(input, null, true, WallpaperManager.FLAG_SYSTEM)
        }
    }

    stopSelf()
    return START_NOT_STICKY
}

2. 适配小米机型的特殊逻辑 #

通过判断设备厂商，针对小米机型调整调用逻辑，增加异常重试：

private fun isXiaomiDevice() = Build.MANUFACTURER.equals("Xiaomi", ignoreCase = true)

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    val uriString = intent?.getStringExtra("uri") ?: run {
        stopSelf()
        return START_NOT_STICKY
    }
    val uri = Uri.parse(uriString)

    contentResolver.openInputStream(uri)?.use { input ->
        val wpm = WallpaperManager.getInstance(this@ChangeBackgroundService)
        try {
            if (isXiaomiDevice()) {
                if (DataStoreHandler.getLockScreenSwitchState(this)) {
                    // 小米机型优先尝试设置锁屏，失败则重试系统壁纸
                    wpm.setStream(input)
                } else {
                    wpm.setStream(input, null, true, WallpaperManager.FLAG_SYSTEM)
                }
            } else {
                // 原逻辑
                if (DataStoreHandler.getLockScreenSwitchState(this)) {
                    wpm.setStream(input)
                } else {
                    wpm.setStream(input, null, true, WallpaperManager.FLAG_SYSTEM)
                }
            }
        } catch (e: Exception) {
            // 捕获异常后重置输入流重试（仅小米机型）
            if (isXiaomiDevice() && input.markSupported()) {
                input.reset()
                wpm.setStream(input, null, true, WallpaperManager.FLAG_SYSTEM)
            }
        }
    }

    stopSelf()
    return START_NOT_STICKY
}

3. 改用异步线程执行 #

在子线程中处理壁纸设置，避免阻塞主线程：

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    Thread {
        val uriString = intent?.getStringExtra("uri") ?: run {
            stopSelf()
            return@Thread
        }
        val uri = Uri.parse(uriString)

        contentResolver.openInputStream(uri)?.use { input ->
            val wpm = WallpaperManager.getInstance(this@ChangeBackgroundService)
            try {
                if (DataStoreHandler.getLockScreenSwitchState(this@ChangeBackgroundService)) {
                    wpm.setStream(input)
                } else {
                    wpm.setStream(input, null, true, WallpaperManager.FLAG_SYSTEM)
                }
            } catch (e: Exception) {
                e.printStackTrace()
            }
        }
        stopSelf()
    }.start()
    return START_NOT_STICKY
}

4. 添加异常日志上报 #

接入日志上报工具（如Firebase Crashlytics），捕获并上报异常信息，便于定位具体问题：

try {
    // 壁纸设置逻辑
} catch (e: Exception) {
    FirebaseCrashlytics.getInstance().recordException(e)
}

额外注意事项 #

• 确保已申请SET_WALLPAPER权限，小米机型可能需要额外申请“修改系统设置”权限（可通过Settings.ACTION_MANAGE_WRITE_SETTINGS引导用户授权）。
• 对于Firebase Storage的图片，建议先下载到本地缓存，使用本地URI进行设置，避免直接使用云端URI导致输入流读取异常。

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