适配Android S+（API31+）MQTT集成报错：PendingIntent需指定FLAG

问题原因 #

Android 12（API 31）及以上版本对PendingIntent的创建新增了强制要求：必须指定FLAG_IMMUTABLE或FLAG_MUTABLE标记。你使用的MQTT客户端库（如Eclipse Paho）内部创建PendingIntent时未适配该规则，导致抛出IllegalArgumentException。

解决方案 #

方案1：升级MQTT客户端库（推荐） #

如果使用的是Eclipse Paho Android Service，直接升级到1.1.5及以上版本，新版本已内置适配Android 12+的代码，无需修改业务逻辑。

修改项目依赖（以Gradle为例）：

dependencies {
    implementation 'org.eclipse.paho:org.eclipse.paho.android.service:1.1.5'
    implementation 'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.2.5'
}

方案2：手动设置PendingIntent标记（无法升级库时使用） #

在创建MqttConnectOptions时，根据系统版本添加对应的标记，确保兼容Android 12+及以下版本：

修改你的connect函数：

import android.os.Build
import android.app.PendingIntent

fun connect(
    username: String,
    password: String,
    cbConnect: IMqttActionListener,
    cbClient: MqttCallback
) {
    mqttClient.setCallback(cbClient)
    val options = MqttConnectOptions()
    options.userName = username
    options.password = password.toCharArray()
    
    // 添加PendingIntent标记适配Android 12+
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        // 大部分MQTT场景下使用FLAG_IMMUTABLE即可，若需动态更新PendingIntent内容则用FLAG_MUTABLE
        options.setPendingIntentFlags(PendingIntent.FLAG_IMMUTABLE)
    }
    
    try {
        mqttClient.connect(options, null, cbConnect)
    } catch (e: MqttException) {
        e.printStackTrace()
    }
}

注意事项 #

• FLAG_IMMUTABLE：表示PendingIntent不可修改，适合大多数不需要动态更新的MQTT场景，安全性更高。
• FLAG_MUTABLE：仅当你需要后续修改PendingIntent的内容时使用，比如更新通知内容等，使用时需注意安全风险。

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